FLUX 3 API'si Nasıl Kullanılır: Eksiksiz Geliştirici Rehberi

Hızlı Yanıt

FLUX 3 Black Forest Labs’in, senkronize sesle metinden videoya ve görüntüden videoya üretim için çok modlu video modelidir. CometAPI’de üretim model kimliği flux-3’tür. Doğrulanmış asenkron iş akışı, bir görevi oluşturmak için POST /v1/videos, onu yoklamak için GET /v1/videos/{task_id} ve tamamlanan MP4’ü indirmek için GET /v1/videos/{task_id}/content kullanır.

Kullanılabilirlik güncellemesi (24 Eylül 2026’da doğrulandı): Black Forest Labs, FLUX 3 Video’yu Temmuz Erken Erişim aşamasının ötesine taşıdı ve 4 Ağustos 2026’da BFL API ve seçilmiş ortaklar üzerinden metinden videoya ve görüntüden videoya ilk sürümü genel kullanıma açtı. CometAPI, 13 Ağustos 2026’da Video API biçiminde üretim model kimliği flux-3’ü ekledi. Kullanılabilirlik, alanlar ve fiyatlar için BFL sürüm duyurusunu ve canlı CometAPI model sayfasını nihai kaynak olarak kullanın.

FLUX 3 Erken Erişimden Bu Yana Ne Değişti?

Önemli değişiklik operasyonel kullanılabilirliktir. Erken dönem kapsamı Temmuz ayındaki başvuruya dayalı yayına odaklanıyordu; BFL’nin Ağustos sürümü ise çağrılabilir bir video uç noktası, yayımlanmış kısıtlar ve üretim fiyatlandırması getirdi. Bunu takiben CometAPI, flux-3’ü birleşik Video API iş akışı üzerinden sundu.

CometAPI’nin önceki makalesi, FLUX 3 API: Availability, Early Access, Video & Dev, lansman geçmişi ve Temmuz ayındaki ön değerlendirme için faydalı olmaya devam ediyor. Daha geniş Best AI Video APIs in 2026 karşılaştırması, pazar düzeyinde seçim konusunu ele alır. Bu kılavuz ise bu konuları özlü tutar ve çalışan istekler, yoklama, istemler, maliyet kontrolü ve üretim kullanımına odaklanır.

FLUX 3 Nedir?

FLUX 3, video, ses, görseller ve eylemle ilişkili tahmin için BFL’nin çok modlu model ailesidir. Mevcut video sürümü, tek bir sağlayıcı-yerel uç nokta üzerinden metinden videoya, görüntüden videoya ve video devamı destekler.

Video geliştiricileri için öne çıkan yetenekler: 24 fps’de 20 saniyeye kadar, HD veya Full HD çıktı, senkronize ses, dudak senkronuyla çok dilli konuşma, tek üretimde birden fazla çekim ve görüntüden videoya kontrol için on adede kadar sabitlenmiş ana kare.

FLUX 3 API Özellikleri

FLUX 3 Video Ne Kadar İyi?

BFL, tümü-tümüne insan tercihi değerlendirmesinde metinden videoya için 1135 Elo skoru bildirmektedir. Aynı yayımlanan karşılaştırmada, FLUX 3 görüntüden videoya tercihte Seedance 2.0 ile berabere kalmış ve test edilen diğer modellerin önünde yer almıştır.

Bu sonuçlar konumlandırma açısından faydalı kanıtlardır; ancak bunlar satıcı tarafından yürütülen insan tercihi değerlendirmeleridir, bağımsız bir üretim kıyaslaması değildir. Geçit gecikmesini, kuyruk güvenilirliğini, maliyet tutarlılığını veya tekrarlı üretim kararlılığını ölçmezler; bu nedenle üretim ekipleri kendi istem setlerini yine de değerlendirmelidir.

FLUX 3 Kıyaslama Performansı

Kaynak: Black Forest Labs — FLUX 3 Video, Part 1: Generation.

FLUX 3 API’sini Kullanmadan Önce Gerekenler

• Bir CometAPI hesabı ve arka uç ortam değişkeninde saklanan bir API anahtarı.
• Konuyu, hareketi, kamera yönünü, atmosferi ve gereken ses veya diyalogu tanımlayan bir istem.
• Video üretimi asenkron olduğu için sağlam bir iş/görev işleme yolu.
• Yinelemeli test için yeterli kredi; faturalama üretilen süre ve çözünürlüğe bağlıdır.

Anahtarı CometAPI API panosunda oluşturun. Ön uç JavaScript, mobil paketler, genel depolar veya ekran görüntülerine koymayın.

FLUX 3 Model Kimliği ve Uç Noktalar

CometAPI ile FLUX 3 API Nasıl Kullanılır

Adım 1: API Anahtarınızı Ayarlayın

macOS veya Linux’ta:

export COMETAPI_KEY="your_api_key"

Windows PowerShell’de:

$env:COMETAPI_KEY="your_api_key"

Adım 2: Bir FLUX 3 Videosu Oluşturun

Güncel FLUX 3 hızlı başlangıcı, model, prompt, seconds ve size ile multipart isteği kullanır. Bu örnek beş saniyelik 720p bir klip ister:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=flux-3" \
  -F "prompt=A paper boat glides across a still pond in soft morning light" \
  -F "seconds=5" \
  -F "size=1280x720"

Bu istek bir işi başlatır. Uygulamayı aynı HTTP yanıtında bitmiş bir MP4 alacak şekilde tasarlamayın.

Adım 3: Görev Kimliğini Kaydedin

Oluşturma isteği başarılı olduktan hemen sonra tanımlayıcıyı kalıcı kılın:

{
  "id": "video_task_id",
  "status": "queued"
}

Yoklamaya başlamadan önce görev kimliğini kullanıcı veya iş kaydıyla birlikte depolayın. Bir süreç yeniden başlatması, faturalandırılmış bir üretimin kaybolmasına yol açmamalıdır.

Adım 4: Video Durumunu Yoklayın

curl https://api.cometapi.com/v1/videos/{task_id} \
  -H "Authorization: Bearer $COMETAPI_KEY"

İlk olarak on saniye gibi makul bir aralıkla başlayın. completed, succeeded veya success durumlarını nihai başarı; failed, failure, cancelled veya canceled durumlarını nihai başarısızlık olarak değerlendirin.

Adım 5: MP4’ü İndirin

curl https://api.cometapi.com/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output flux3_output.mp4

Tamamlandıktan sonra dosyayı geçici bir sağlayıcı URL’sini kalıcı varlık olarak tutmak yerine kendi nesne depolamanıza veya medya hattınıza kopyalayın.

FLUX 3 Video Üretimi için Tam Python İş Akışı

Aşağıdaki örnek bir iş oluşturur, kimliğini kaydeder, tamamlanana kadar yoklar, başarısızlık durumlarını kontrol eder, MP4 imzasını doğrular ve çıktıyı diske yazar.

import os
import time
from pathlib import Path

import requests

api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files={
        "model": (None, "flux-3"),
        "prompt": (
            None,
            "A product bottle rotates slowly on wet black stone, "
            "soft rim lighting, macro lens, realistic reflections.",
        ),
        "seconds": (None, "5"),
        "size": (None, "1280x720"),
    },
    timeout=120,
)
response.raise_for_status()

task = response.json()
data = task.get("data") or {}
task_id = (
    task.get("id")
    or task.get("task_id")
    or data.get("id")
    or data.get("task_id")
)
if not task_id:
    raise RuntimeError(f"Create response has no task ID: {task}")

while True:
    response = requests.get(
        f"{base_url}/v1/videos/{task_id}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    data = task.get("data") or {}
    status = str(task.get("status") or data.get("status") or "").lower()
    progress = task.get("progress") or data.get("progress") or "unknown"
    print(f"Status: {status or 'unknown'}; progress: {progress}")

    if status in {"failed", "failure", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {task}")
    if status in {"completed", "succeeded", "success"} or progress == "100%":
        break
    time.sleep(10)

response = requests.get(
    f"{base_url}/v1/videos/{task_id}/content",
    headers=headers,
    timeout=300,
)
response.raise_for_status()
video = response.content

if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("Content response is not a non-empty MP4 file")

output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
output_path = output_dir / f"{task_id}.mp4"
output_path.write_bytes(video)
print(f"Saved: {output_path} ({len(video)} bytes)")

Görüntüden Videoya ve Ana Kareler Nasıl Kullanılır

CometAPI FLUX 3 sayfası, görüntüden videoya yeteneğini desteklenen bir kabiliyet olarak listeler. Güncel genel örneği metinden videoya’yı gösterdiğinden, başka bir modelden kopyalanmış bir referans görsel alanının değişmeden çalışacağını varsaymadan önce canlı gateway dokümantasyonunu doğrulayın.

BFL’nin yerel API’si açıktır: görüntüden videoya, i2v modu ve keyframes alanını kullanır. Bir görsel başlangıç karesini sabitler, iki görsel başlangıç ve bitişi sabitleyebilir ve zamanlanmış on görsele kadar kesintisiz bir klip için storyboard oluşturabilir.

BFL-Yerel Ana Kare Örneği

curl -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "They sprint through the lantern-lit alley as the camera tracks behind them.",
    "keyframes": [
      [0, "data:image/png;base64,<first-frame>"],
      [8, "data:image/png;base64,<last-frame>"]
    ],
    "duration": 8
  }'

Sağlayıcı-yerel ve gateway parametrelerini ayrı adaptörlerde tutun. BFL, mode, keyframes, start_video, resolution ve draft gibi alanlar kullanır; CometAPI’nin doğrulanmış örneği model, prompt, seconds ve size kullanır.

FLUX 3 API Parametrelerinin Açıklaması

Daha İyi FLUX 3 İstemleri Nasıl Yazılır

BFL’nin video istem kılavuzu, konu ve eylem, kamera, sahne ve atmosfer, hareket kalitesi ve süreklilik için net yönlendirme önerir. Ses odaklı sahnelerde diyalog, ses, ses efektleri ve ambiyansı belirtin.

Pratik Bir İstem Yapısı

Subject + Environment + Action + Camera + Lighting
+ Dialogue/Voice + Sound Effects + Ambience + Constraints

Sinematik İstem

A lone cyclist rides through a rain-soaked neon street at midnight.
The camera begins low beside the rear wheel, then rises into a smooth tracking shot.
Reflections stretch across wet asphalt under moving cyan and magenta light.
Audio: steady rainfall, chain noise, distant traffic, no music, no dialogue.
Keep the same rider, bicycle, jacket, and weather throughout the shot.

Ürün Videosu İstemi

A premium stainless-steel espresso machine stands on a dark stone counter.
Begin with a macro close-up of water droplets on the metal housing.
Orbit clockwise as the machine brews; steam catches warm side light.
Finish on a clean three-quarter hero angle with the cup in the foreground.
Audio: pump vibration, steam hiss, ceramic contact, quiet cafe ambience.
Do not change the product shape, logo placement, material, or color.

Diyalog ve Yerel Ses İstemi

A young chef works alone in a compact Tokyo ramen shop at night.
Start close on boiling broth, then pull back as the chef sets down a bowl.
Warm tungsten lighting, natural reflections, documentary handheld motion.
The chef quietly says in Japanese: 「お待たせしました。」
Audio: bubbling broth, soft rain outside, distant street traffic.
No subtitles and no background music.

“make a cinematic ramen shop video” gibi bir istem, hareket, kadraj, ses ve sürekliliği belirtmeden bırakır. Açık yönlendirme, daha test edilebilir bir üretim tanımı sunar.

FLUX 3 API Fiyatlandırması

BFL fiyatlandırması iş akışına özeldir: tam metinden videoya ve görüntüden videoya oluşturma, HD’de saniyesi $0.17 veya FHD’de $0.29; HD Taslak Mod saniyesi $0.06’dır. Video devamı HD’de saniyesi $0.43 veya FHD’de $0.54; HD taslaklar saniyesi $0.12’dir. CometAPI şu anda flux-3 için 720p’de saniyesi $0.136 ve 1080p’de $0.232 listeler. Büyük bir iş yükünden önce canlı fiyatları doğrulayın.

Son iki sütunu okuma: değerler önce HD/720p, sonra FHD/1080p olarak gösterilmiştir.

Yineleme Maliyetlerini Nasıl Azaltırsınız

• 1080p’ye geçmeden önce 720p’de prototip oluşturun.
• Kompozisyonu, hareketi ve istem yorumunu doğrulamak için beş saniyelik klipler kullanın.
• Bir seferde bir büyük istem değişkenini değiştirin.
• BFL yerel API’sini kullanırken, tam kalite işleme geçmeden önce Taslak Modu’nu test edin.
• Başarılı istemleri ve referans kararlarını uygulama metaverilerinde saklayın.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

FLUX 3, Wan 3.0 ve Seedance 2.5’i tek bir evrensel kazanan aramak yerine iş akışına göre karşılaştırın. Yetkili özellik bağlantıları aşağıdaki tablo başlığında kalır.

Fiyatlandırma notu: Başlangıç fiyatları, kalite veya çözünürlüğün birebir karşılaştırması değildir. Bütçeleme için her canlı model sayfasındaki çözünürlük-özel tabloyu kullanın.

Hangi Video API’sini Seçmelisiniz?

• Hareket açısından tutarlı görsel-işitsel çekimler, yerel ana kareler veya devam kontrolü gerekiyorsa FLUX 3’ü seçin.
• İş akışı birçok girdi türüyle başlıyor ve 30 saniyelik üretim penceresi önemliyse Wan 3.0’ı seçin.
• Daha uzun, referans ağırlıklı öyküleme ve güçlü kimlik, ürün ve stil kontrolü gerektiğinde Seedance 2.5’i seçin.

FLUX 3 API Üretim En İyi Uygulamaları

Asenkron İşleri Kalıcı Durum Olarak Saklayın

Gönderimden hemen sonra görev kimliğini kaydedin. Sunucu yeniden başlatması veya işçi yinelenmesi, uygulamanın orijinal görevi kaybetmesi nedeniyle kullanıcının tekrar ödeme yapmasını gerektirmemelidir.

Sık Yoklamadan Kaçının

Canlı dokümantasyon aksini önermedikçe on saniye civarında başlayın. Her saniye yoklama, deneyimi anlamlı şekilde iyileştirmeden istek yükünü artırır.

İndirmeyi Doğrulayın

Bir varlığı tamamlandı olarak işaretlemeden önce içerik uzunluğunu ve MP4 imzasını kontrol edin. Başarılı bir HTTP yanıtı, gövdenin geçerli bir video olduğunu her zaman kanıtlamaz.

Yerel ve Gateway Şemalarını Ayırın

BFL-yerel ve CometAPI istekleri için ayrı adaptörler tutun. Bu, mode, keyframes ve start_video gibi yerel alanların model, prompt, seconds ve size bekleyen bir gateway çağrısına sızmasını önler.

Tam Hata Bağlamını Saklayın

HTTP durum kodunu, yanıt gövdesini, görev kimliğini, model kimliğini, istem sürümünü, boyutu, süreyi ve dahili iş kimliğini kaydedin. API anahtarını maskeyin.

Yayınlamadan Önce Küçük Bir Değerlendirme Seti Kullanın

Kamera hareketi, insanlar, ürünler, tipografi, diyalog, yüksek hareketli sahneler ve gereken en-boy oranlarını kapsayan 10–30 temsil edici istem oluşturun. Bir model veya entegrasyon sürümü değiştiğinde aynı seti çalıştırın ve video üretimi stokastik olduğundan önemli istemleri tekrarlayın.

SSS

CometAPI’de FLUX 3 model kimliği nedir?

Güncel model kimliği flux-3’tür.

FLUX 3 hangi CometAPI uç noktasını kullanır?

Doğrulanmış Video API iş akışı POST /v1/videos, ardından GET /v1/videos/{task_id} ve GET /v1/videos/{task_id}/content kullanır.

FLUX 3 eşzamanlı mı?

Hayır. Bunu asenkron bir iş olarak ele alın: gönderin, görev kimliğini kalıcı kılın, yoklayın ve indirin.

FLUX 3 ne kadar süre üretebilir?

BFL, T2V/I2V için 5–20 saniye ve devam için 5–15 saniye olarak dökümante eder.

FLUX 3 ses üretir mi?

Evet. BFL, yerel API’sinde varsayılan olarak etkin senkronize ses dökümante eder.

FLUX 3 görüntüden videoya destekler mi?

Evet. CometAPI görüntüden videoya desteğini listelerken, BFL’nin yerel API’si i2v modu ve ana kareler üzerinden uygular.

BFL ana karelerini CometAPI üzerinden olduğu gibi kullanabilir miyim?

Bunu varsaymayın. İstek şemaları farklıdır; bir referans görsel iş akışını sevk etmeden önce güncel CometAPI hızlı başlangıcını doğrulayın.

CometAPI’de beş saniyelik bir FLUX 3 videonun maliyeti ne kadar?

CometAPI’de şu anda listelenen oranlara göre, beş saniye 720p’de $0.68 veya 1080p’de $1.16’dır. Canlı referans bağlantısı için yukarıdaki konsolide fiyat tablosuna bakın.

FLUX 3, Wan 3.0 veya Seedance 2.5’ten daha mı iyi?

İş akışına bağlıdır. Hareket açısından tutarlı görsel-işitsel çekimler ve BFL-yerel ana kare veya devam kontrolü için FLUX 3 ikna edicidir; Wan 3.0 girdi çeşitliliğini vurgular; Seedance 2.5 ise daha uzun, referans ağırlıklı öykülemeyi vurgular.

Sonuç

FLUX 3 artık CometAPI üzerinde çalışan bir asenkron Video API yoluna sahip; BFL’nin yerel dokümantasyonu ise ana kareler, devam, ses ve Taslak Mod için daha derin kontroller sunar.

Güvenli bir entegrasyon yolu basittir: kısa bir 720p metinden videoya istekle başlayın, görev kimliğini kalıcı kılın, temkinli yoklayın, MP4’ü indirin ve doğrulayın; ardından istem şablonları, depolama, yeniden deneme mantığı ve tekrarlanabilir bir değerlendirme seti ekleyin. Yerel ve gateway şemalarını ayrı tutun ve alanları veya fiyatları sabitlemeden önce canlı model sayfasını doğrulayın.