CometAPI ile geliştirinBirden çok model için tek bir API mi gerekiyor?İş akışını Playground'da test edin, ardından model ve maliyet kullanım senaryonuza uyduğunda bir API anahtarı oluşturun.
FLUX 3 API'si Nasıl Kullanılır: Eksiksiz Geliştirici Rehberi
CometAPI ile FLUX 3 API'yi kullanın: video uç noktaları, Python ve cURL örnekleri, asenkron yoklama, fiyatlandırma, istemler, kıyaslamalar ve üretim uygulamaları.
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 ’ü ekledi. Kullanılabilirlik, alanlar ve fiyatlar için ve canlı CometAPI model sayfasını nihai kaynak olarak kullanın.
Ö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
Özellik
BFL resmi özellik
CometAPI entegrasyonu
Birincil iş akışları
Metinden videoya, görüntüden videoya, video devamı
Metinden videoya ve görüntüden videoya listelenmiş
Azami süre
T2V/I2V için 5–20 s; V2V için 5–15 s
Gateway istekleri için canlı hızlı başlangıç değerlerini kullanın
Kare hızı
24 fps
Sağlayıcı çıktısı
Çözünürlük
Yerel olarak rHD; video yükseltici üzerinden FHD. BFL’nin güncel FLUX 3 Video dokümantasyonu 4K/UHD çıktıyı listelemiyor. “4MP’ye kadar” özelliği FLUX.2 görsel modelleri içindir, FLUX 3 Video için değildir.
720p ve 1080p fiyatlandırması listelenmiş
Yerel ses
Evet; varsayılan olarak etkin
Çıkış özelliği etkin entegrasyonu takip eder
Görsel kontrol
Yerel I2V’de 1–10 ana kare
Mevcut gateway referans görsel eşlemesini doğrulayın
En-boy oranları
21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16
Hızlı başlangıç 1280x720 gibi açık boyutlar kullanır
Çağırma
Asenkron
Oluştur → sorgula → indir
CometAPI model kimliği
—
flux-3
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ı
Metrik
Yayımlanan sonuç
Yorum
Metinden videoya tümü-tümüne Elo
1135
BFL, FLUX 3’ün dahili karşılaştırmasında lider olduğunu bildiriyor
Görüntüden videoya tercih
Seedance 2.0 ile beraberlik
Satıcı kaynaklı yön gösterici sonuç; üçüncü taraf lider tablosu değil
Değerlendirme türü
İnsan tercihi
Algılanan çıktı kalitesini ölçer, API altyapısını değil
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.
İ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.
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ı
Parametre
API
Ne kontrol eder
Pratik öneri
model
CometAPI
Model seçimi
flux-3 kullanın
prompt
Her ikisi
Sahne, eylem, kamera, ses
Zaman içinde görünür değişimi tarif edin
seconds
CometAPI örneği
İstenen klip uzunluğu
Ayarlama yaparken 5–8 saniye ile başlayın
size
CometAPI örneği
Çıktı boyutları
Ekonomik test için 1280x720 ile başlayın
mode
BFL yerel
t2v / i2v / v2v / draft_enhance
Gateway eşlemediği sürece göndermeyin
duration
BFL yerel
T2V/I2V için 5–20 s; V2V için 5–15 s
Yerel API’de auto desteklenir
resolution
BFL yerel
hd veya fhd; FLUX 3 Video için 4K/UHD şu anda listelenmiyor
FHD, video yükseltici üzerinden tamamlanır
generate_audio
BFL yerel
Senkronize ses açık/kapalı
Varsayılan true
draft
BFL yerel
Hızlı önizleme modu
Daha düşük maliyetli yaratıcı iterasyon için kullanın
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.
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.
Sağlayıcı / iş akışı
HD / 720p tam
FHD / 1080p tam
Taslak
5 sn tam üretim
10 sn tam üretim
BFL T2V
$0.17/s
$0.29/s
$0.06/s (HD)
$0.85 / $1.45
$1.70 / $2.90
BFL I2V
$0.17/s
$0.29/s
$0.06/s (HD)
$0.85 / $1.45
$1.70 / $2.90
BFL V2V continuation
$0.43/s
$0.54/s
$0.12/s (HD)
$2.15 / $2.70
$4.30 / $5.40
CometAPI flux-3
$0.136/s
$0.232/s
Listelenmedi
$0.68 / $1.16
$1.36 / $2.32
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.
Boyut
FLUX 3
Resmi özellikler
Wan 3.0
Resmi özellikler
Seedance 2.5
Resmi özellikler
Azami klip uzunluğu
T2V/I2V için 20 s’ye kadar
30 s’ye kadar
30 s’ye kadar
Senkronize ses
Evet
Evet
Evet
Metinden videoya
Evet
Evet
Evet
Görüntüden videoya
Evet
Evet
Evet
Referans stratejisi
10 adede kadar yerel ana kare
Geniş çok modlu ve Omni-Reference iş akışı
Büyük çok modlu referans kapasitesi
Devam/düzenleme
Yerel BFL v2v devamı
Uzun biçim ve düzenleme iş akışları
Uzatma ve düzenleme iş akışları
Ayırt edici güç
Hareket mantığı, çoklu çekimler, senkronize görsel-işitsel çıktı
Girdi çeşitliliği ve 30 saniyelik üretim
Uzun öyküleme ve referans ağırlıklı kontrol
CometAPI başlangıç fiyatı
$0.136/s
$0.04/s
$0.0824/s
En uygun kullanım
Sinematik veya gerçekçi görsel-işitsel çekimler
Hepsi-bir-arada çok modlu üretim hatları
Daha uzun, kimlik kontrollü öyküleme
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.
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.