FLUX.2, Black Forest Labs’in ikinci nesil görüntü üretimi ve görüntü düzenleme model ailesidir (25 Kasım 2025’te yayımlandı). Üretim düzeyinde fotogerçekçilik, 4 MP’ye kadar çoklu referans düzenleme, yapılandırılmış/JSON istemleme ve yönetilen uç noktalar (Pro, Flex) ile açık ağırlık seçenekleri (Dev) sunar.
İyi haber şu ki CometAPI, Flux.2 API’sini entegre etti. Bu kılavuz, FLUX.2’nin ne olduğunu, API’nin nasıl çağrılacağını ve ileri düzey iş akışlarını (metin→görüntü, esnek kontrol, çoklu referans düzenleme) kod örnekleri ve en iyi uygulamalarla açıklar.
FLUX.2 nedir ve neden önemlidir?
FLUX.2, FLUX görüntü modeli ailesinin devamı niteliğindedir — yüksek doğrulukta metinden görüntü üretimi ve üretim çözünürlüklerinde (yaklaşık 4 megapiksele kadar) çoklu referans görüntü düzenleme için tasarlanmıştır. FLUX.2, gösterilerden ziyade gerçek yaratıcı iş akışları (marka güvenli içerikler, referanslar arasında tutarlı karakterler ve stiller, daha iyi tipografi ve küçük detaylar) için geliştirilmiş olup, üretilen görüntü ile gerçek görsel arasındaki farkı kapatmayı hedefler.
FLUX.2’nin sağlaması için tasarlandığı başlıca çıktılar
- Reklam, ürün görselleri ve UI maketleri için uygun fotogerçekçi çıktılar.
- Yerleşik çoklu referans düzenleme: birden fazla giriş görüntüsündeki öğeleri tek bir düzenlemede birleştirme, değiştirme veya kompozit oluşturma.
- Farklı kullanım senaryolarına yönelik varyantlar: açıkça erişilebilir geliştirici modelleri, üretim için optimize edilmiş Pro uç noktası ve düşük seviyeli kontrol sunan Flex uç noktası.
Genel hatlarıyla FLUX.2, anlamsal dayanak için bir görsel–dil modeliyle birleşen gizil üretici bir omurgayı (flow/transformer mimarisi) ve varyantlar arasında paylaşılan bir gizil uzay sağlayan yeni eğitilmiş bir VAE’yi bir araya getirir. Bu tasarım, temsili eğitilebilir kılarken hem üretimi hem de yeniden oluşturmayı (düzenlemeyi) daha yüksek sadakatle gerçekleştirmesine olanak tanır. Açık VAE özellikle dikkat çekicidir; çünkü barındırılan ve kendi kendine barındırılan iş akışları için gizil uzayı standartlaştırır.
Neden önemli: dili ve gizil akış eşleştirmeyi birleştirmek, daha güçlü isteme uyum (böylece çok parçalı, bileşimsel talimatlar öngörülebilir davranır), daha iyi tipografi ve hem üretimi hem de birden çok referansla düzenlemeyi destekleyen tek bir mimari sağlar. Yaratıcılar için bu, karmaşık talimatlar ve karma girdiler (metin + görseller) için daha güvenilir çıktılar demektir.
FLUX.2 API’sine nasıl erişirim?
Ortamı hazırlayın
CometAPI’ye kayıt olup giriş yapın ve profil panelinizden API anahtarınızı alın. İdeal olarak bir geliştirici olarak biraz API bilgisine sahip olmanız önerilir (bu konuda destek sağlayacağız, bu yüzden endişelenmeyin).
Ayrıca istediğiniz istek yöntemini ve uygun FLUX.2 modelini seçmeniz gerekecek.
Hangi uç noktalar ve kimlik doğrulama gereklidir?
Replicate Predictions API, standart Replicate formatı üzerinden Black Forest Labs’in çeşitli FLUX modellerini kullanarak yüksek kaliteli görüntüler üretmeye olanak tanır. Bu API, hızlı prototiplemeden profesyonel düzeyde görüntü üretimine kadar farklı kullanım durumları için optimize edilmiş kapsamlı bir FLUX model varyant yelpazesini destekler. Kullanıcılar, URL yolundaki model adını değiştirerek (https://api.cometapi.com/replicate/v1/models/{models}/predictions) farklı modeller arasında sorunsuzca geçiş yapabilir, bu da onu çeşitli yaratıcı ve ticari uygulamalar için esnek kılar.
CometAPI https://api.cometapi.com/flux/v1/{model} altında yönetilen uç noktalar sunar ve görüntü oluşturma ve düzenleme için flux-2-pro, flux-2-flex ve flux-2-flex gibi uç noktalar adlandırır. İsteklerde x-key başlığında bir API anahtarı gereklidir.
Model ailesi ve hesaplama ödünleri
- FLUX.2 (open weights) — Yerel kontrol, araştırma deneyleri veya kendi altyapınızda çıkarım çalıştırmanız gerektiğinde kullanın. Dev açık ağırlıklıdır (32B) ve keşif amaçlı araştırmalar ve ince ayar için mükemmeldir. Daha fazla yapılandırılabilirlik sunar, ancak altyapı ve optimizasyondan siz sorumlusunuz.
- FLUX.2 pro — Üretim için hız, kalite ve maliyet arasında en iyi denge. Pro, öngörülebilir gecikme, tutarlı istem uyumu, hızlı throughput ve API üzerinden 8’e kadar referans görsel desteği (API üzerinden toplam 9 MP) için ayarlanmıştır. Yüksek hacimli düzenleme ve güvenilirlik ile öngörülebilir fiyatlandırma gerektiğinde bunu kullanın.
- FLUX.2 (managed + controllability) — Düşük seviyeli üretim kontrollerini (ör.
steps,guidance) sunar ve daha fazla referansı (10’a kadar) ve kabul edilecek daha yüksek gecikme ve maliyet karşılığında biraz daha yüksek kalite/detayı destekler. Nihai yaratıcı kontrol — tipografi sadakati, tam renkler veya son derece ayrıntılı kompozisyon ayarlamaları — gerektiğinde Flex’i kullanın.
İlk prototipleri Dev veya düşük maliyetli Pro planında yapın, ardından ölçek için Pro’ya veya yüksek kontrol gerektiren nihai renderlar için Flex’e geçin.
FLUX.2 API’sini nasıl kullanırım?
İstek yaşam döngüsü (görev + yoklama modeli)
Düzenleme/üretim isteklerine verilen yanıtlar, polling_url ve id içeren birer görev nesnesidir; bir istek oluşturur, sonra imzalı sonuç URL’sini almak için yoklama (veya web kancaları) yaparsınız. İmzalı URL’ler kısa ömürlüdür (genellikle ~10 dakika), bu yüzden çıktıları hızlıca alın.
Barındırılan API, eşzamansız bir görev modelini izler:
- Bir üretim isteği POST edin → bir
task id,polling_urlve tahminicostdöner. status == "Ready"olana kadarpolling_url’ü yoklayın, ardından görüntü sonucunu (genellikle base64 veya barındırılan bir URL) alın.
Örnek: Python (requests) — gönder ve yokla
import time, requests, os
API_KEY = os.environ
API_URL = "https://api.cometapi.com/flux/v1/flux-2-pro"
payload = {
"prompt": "A high-end product photo of a ceramic mug on a wooden desk, soft window light.",
"width": 1024, "height": 1024, "seed": 42
}
r = requests.post(API_URL, headers={"x-key": API_KEY, "accept":"application/json"}, json=payload)
r.raise_for_status()
task = r.json()
polling_url = task
while True:
time.sleep(0.5)
status_r = requests.get(polling_url, headers={"x-key": API_KEY})
status_r.raise_for_status()
status = status_r.json()
if status == "Ready":
print("Result URL:", status)
break
elif status in ("Error", "Failed"):
print("Generation failed:", status)
break
Bu desen (gönder → yokla veya webhook), yönetilen uç noktalar için birincil senkron/asenkron akıştır.
Görüntü düzenleme — minimal örnek (girdi URL’siyle curl)
curl -X POST "https://api.cometapi.com/flux/v1/flux-2-pro" \
-H "accept: application/json" \
-H "x-key: $CometAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Replace the background with a sunlit seaside boardwalk, keep the person intact and match lighting",
"input_image": "",
"width": 2048,
"height": 1536
}'
Çoklu referans düzenleme için input_image, input_image_2, input_image_3, … kullanın (Pro API üzerinden 8’e kadar referansı; Flex 10’a kadar; Dev ise belleğe bağlı olarak önerilen maksimum ~6 referansı destekler).
Hangi temel parametreleri göndermeliyim?
Önemli istek gövdesi alanları (görüntü düzenleme/üretim) şunları içerir:
guidancevesteps— ince taneli kontrol sağlar.prompt(string) — 32K belirtece kadar; ayrıntılı doğal dil veya yapılandırılmış JSON olabilir.input_image(string) — düzenlemeler için gereklidir (URL veya base64).input_image_2…input_image_9— çoklu referans görseller.width/height— 16’nın katları; çıktı en fazla 4 MP.seed— tekrarlanabilirlik için tamsayı.safety_tolerance— moderasyon düzeyi.
Profesyonel metinden görüntü üretimi için FLUX.2 Pro’dan nasıl yararlanabilirim?
FLUX.2 Pro, güvenilir ve yüksek kaliteli çıktılar için ayarlanmıştır. Tutarlı marka düzeyi sonuçlara, hızlı geri dönüşe ve kurumsal SLA’lara ihtiyaç duyduğunuzda kullanın.
İş akışı tarifi — üretim görselleri
- İstemleri ön işleyin: kısa bir “niyet” satırı ve ardından yapılandırılmış bir öznitelikler bölümü (aydınlatma, lens, ruh hali, marka renkleri için renk hex kodları) bulundurun. FLUX.2, marka paletlerini korumaya yardımcı olmak için hex renk yönlendirmesini destekler.
- Muhafazakâr varsayılanlarla başlayın: steps 30–50 ve guidance ölçeği 6–9.0; detaylar için steps’i artırın, sonuçların isteme daha sıkı uymasını istiyorsanız guidance’ı artırın.
- Tekrarlanabilirlik için
seedve deterministik örnekleme kullanın. - Çok denemeli örnekleme için Pro uç noktasını kullanın: N varyasyonu paralelde isteyin ve en iyisini seçin — manuel hiperparametre ayarlamasından daha hızlı ve ucuzdur.
- Son işlem yapın: gürültü giderme, küçük ton eşleme veya vektör tarzı rötuşlar için deterministik bir hat kullanın. Yerel çıktının üzerinde ihtiyacınız varsa küçük bir GAN veya süper çözünürlük geçişi düşünün.
Bu adımlar neden yardımcı olur: Pro, hız ve sadakat arasında denge kurar ve genellikle üretim sonrası güvenlik/içerik filtrelerini uygular; bu yüzden müşteriyle yüzleşen varlıklar için mantıklı varsayılandır.
Görüntü üretimi için en iyi ipuçları
1. Üretimde yapılandırılmış istemleme kazanır. İstemleri önceliğe göre düzenleyin: konu → eylem → stil → bağlam. Birçok görselde deterministik kompozisyon gerektiğinde JSON istemleme (scene, subjects, camera, lighting, color_palette) kullanın. Örnek JSON şeması kullanımı (psödo):
{
"scene": "product shot",
"subjects": [
{"type":"mug","pose":"center","style":"ceramic, matte"},
{"type":"background","style":"wooden desk, window light"}
],
"camera": {"focal_length":"85mm","aperture":"f2.8","angle":"slightly above"}
}
2. Tekrarlanabilirlik: Daha sonra yeniden üretmek için seed geçin. İzlenebilirlik için istem + seed → görsel eşlemesini tutan bir katalog oluşturun.
3. Toplu işlem ve orkestrasyon: Büyük üretim çalışmaları için Pro’ya çok sayıda isteği paralelde gönderin, ancak kısıtlama yaşamamak için hız sınırlaması uygulayın; öngörülebilir gecikme için Pro uç noktasını tercih edin. Sonuçlar hazır olduğunda imzalı çıktıları hızlıca indirmek için iş kuyrukları ve işçi havuzları kullanın.
4. Moderasyon ve güvenlik: Moderasyon sıkılığını kontrol etmek için safety_tolerance kullanın. Pro uç noktaları kullanım politikaları ve içerik moderasyonu kancaları içerir; yayınlamadan önce sunucu tarafı kontrolleri entegre edin.
5. Son işleme: Pro çıktıları yüksek kaliteli olsa da zaman zaman küçük rötuşlara ihtiyaç duyabilir. Otomatik bir son işlem adımı (kırpma, renk derecelendirme, kompozit) oluşturun ve marka açısından hassas varlıklar için insan incelemesini sürdürün.
FLUX.2 Flex uç noktasıyla çıktıları nasıl özelleştiririm?
Flex “cerrahi araç” varyantıdır: çıktıyı hassas biçimde şekillendirmek için steps, guidance, negatif istemler, döşeme boyutları ve referans sayıları gibi ayarları ince ayarlayın.
Flex’i ne zaman seçmeli
- Hassas tipografik oluşturma gerektirdiğinizde (UI maketleri, etiketler).
- Poz ve aydınlatma üzerinde kontrolle birden çok referansı kompozitlemeniz gerektiğinde.
- İleri düzey istem teknikleriyle (yapılandırılmış istemler, kısıt zincirleri) deney yaparken.
Örnek — Flex kontrol anahtarları ve etkileri
steps— daha fazla adım = daha ince detay (gecikme pahasına).guidance_scale— daha yüksek = metin istemine daha yakın, daha düşük = daha yaratıcı.negative_prompt— öğeleri açıkça kaldırır (ör. “no watermark, no extra fingers”).tile_size/tiled_inference— çok yüksek çözünürlüklü üretim için çıkarım alanını döşeyerek belleği hız karşılığında kullanın.reference_weights— bazı uç noktalar, pozu vs. stili hangi referansın yönlendirdiğini dengelemek için referansları ağırlıklandırmanıza izin verir.
Pratik ipucu: Karmaşık kompozisyonlar için kompozisyonu doğrulamak adına kısa ve düşük guidance’lı bir önizleme çalıştırın, ardından daha fazla adım ve daha yüksek guidance ile yükseltin. Bu iki aşamalı teknik, maliyeti düşürürken hassas nihai çıktılar sağlar.
Örnek: steps & guidance ile Flex isteği
curl -X POST "https://api.bfl.ai/v1/flux-2-flex" \
-H "Content-Type: application/json" \
-H "x-key: $BFL_API_KEY" \
-d '{
"prompt": "Cinematic movie poster, bold typography at top, main character centered, dramatic rim lighting",
"width": 1536, "height": 2048,
"steps": 50,
"guidance": 7.5,
"seed": 99999
}'
İpucu: Nihai yaratıcı onaylar sırasında Flex’i, büyük ölçekli ve hızlı hatlar için Pro’yu kullanın. Flex, tipografi ve mikro-detay görevlerinde belirgin biçimde daha kontrol edilebilirdir.
Üretim kullanımı için en iyi uygulamalar
Aşağıda, ölçekte FLUX.2’yi entegre etmek için sahada kanıtlanmış kalıplar ve pragmatik öneriler yer alır.
1) Megapiksel takibi ve önbellekleme ile maliyeti kontrol edin
FLUX.2 faturalaması, giriş + çıkış megapikseline dayanır. Yüksek hacimli üretimde, daha yüksek MP nihai rendere yalnızca gerektiğinde yükseltmek üzere küçük önizleme renderlarını (düşük çözünürlükte hızlı adımlar) tercih edin. Oluşturulmuş varlıkları önbelleğe alın (veya farkları depolayın) ve aynı işleri yeniden üretmeyin. Yanıtlarda cost değerini her zaman gösterin ve isteklere göre günlükleyin.
2) Katmanları akıllıca kullanın: önizleme vs nihai render ayrımı
- Prototipleme veya çok sayıda varyasyon için hızlı, düşük adımlı Pro renderları çalıştırın.
- Sadakatin önemli olduğu nihai onaylı çıktılar için Flex veya yüksek MP Pro çalıştırmaları kullanın. Bu hibrit yaklaşım, throughput ile nihai görüntü kalitesi arasında denge kurar.
3) İstem mühendisliği → yapılandırılmış istemler ve JSON
Deterministik kompozisyon gerektiğinde FLUX.2’nin yapılandırılmış JSON istemleme özelliğinden yararlanın (sahne nesneleri, kamera, pozlar, hex renk paletleri). Bu, yinelemeli istemleme döngülerini azaltır ve daha tekrarlanabilir paketlere yol açar. Cloudflare örnekleri, JSON istemlerin çok parçalı formlara gömülü olduğunu gösterir.
4) Seed + sürümlendirme ile tekrarlanabilirlik
Tekrarlanabilir sonuçlar gerektiğinde seed geçin ve meta verilerde model sürümü/zaman damgasını kaydedin. Deterministik varlık hatları için bir manifesto tutun: istem, seed, model varyantı, çözünürlük, referans görsel karmaları. Bu, izlenebilirliği ve geri alma seçeneklerini iyileştirir.
Sonuç
FLUX.2, “etkileyici demo” ile “üretim yaratıcı aracı” arasındaki farkı kapatmaya doğrudan odaklanır. Çoklu referans düzenleme, yüksek çözünürlüklü çıktılar ve bir dizi barındırılan uç nokta (artı açık çıkarım kodu ve kuantize tüketici derlemeleri) ile ekiplere pek çok pratik seçenek sunar: araştırma ve özelleştirme için yerelde çalıştırın veya istikrarlı üretim hatları için barındırılan Pro/Flex uç noktalarını kullanın.
Geliştiriciler, CometAPI aracılığıyla Flux.2 Dev API, Flux.2 Flex API ve Flux.2 Pro API ’ye erişebilir. Başlamak için Playground içinde CometAPI’nin model yeteneklerini keşfedin ve ayrıntılı talimatlar için API guide ’a bakın. Erişmeden önce CometAPI’ye giriş yaptığınızdan ve API anahtarını aldığınızdan emin olun. CometAPI, entegrasyonunuza yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat sunar.
Hazır mısınız?→ CometAPI’ye bugün kaydolun!
Daha fazla ipucu, rehber ve haber için bizi VK, X ve Discord üzerinde takip edin!