FLUX.2, Black Forest Labs'ın ikinci nesil görüntü oluşturma ve düzenleme modeli ailesidir (25 Kasım 2025'te piyasaya sürülmüştür). Üretim düzeyinde fotogerçekçilik, 4 MP'ye kadar çoklu referans düzenleme, yapılandırılmış/JSON komut istemi ve çeşitli yönetilen uç noktalar (Pro, Flex) ve 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 gelişmiş iş akışlarını (metin→görüntü, esnek kontrol, çoklu referans düzenleme), kod örnekleri ve en iyi uygulamalarla açıklıyor.
FLUX.2 nedir ve neden önemlidir?
FLUX.2, FLUX görüntü modelleri ailesinin devamı niteliğindedir ve üretim çözünürlüklerinde (yaklaşık 4 megapiksele kadar) yüksek doğrulukta metinden görüntüye dönüştürme ve çoklu referans görüntü düzenleme için tasarlanmıştır. FLUX.2, demolar yerine gerçek yaratıcı iş akışları (marka açısından güvenli varlıklar, referanslar arasında tutarlı karakterler ve stiller, daha iyi tipografi ve küçük detaylar) için tasarlanmıştır ve üretilen ve gerçek görüntüler arasındaki boşluğu kapatmayı hedefler.
FLUX.2'nin tasarladığı temel sonuçlar şunlardır:
- Reklam, ürün görselleri ve kullanıcı arayüzü tasarımları için uygun fotogerçekçi çıktılar.
- Yerel çoklu referans düzenleme: Tek bir düzenlemede birden fazla giriş görüntüsünden öğeleri birleştirin, değiştirin veya oluşturun.
- Farklı kullanım durumları için varyantlar: Açıkça erişilebilir geliştirici modelleri, üretim için optimize edilmiş bir Pro uç noktası ve düşük seviyeli kontrol için bir Flex uç noktası.
Üst düzeyde, FLUX.2, gizli bir üretken omurgayı (akış/dönüştürücü mimarisi), anlamsal temellendirme için bir görme-dil modeli ve varyantlar arasında paylaşılan bir gizli alan sağlamak için yeni eğitilmiş bir VAE ile birleştirir. Bu tasarım, modelin hem oluşturma hem de yeniden yapılandırma (düzenleme) işlemlerini daha yüksek doğrulukta gerçekleştirmesini sağlarken, temsili eğitim ve ince ayar için öğrenilebilir tutar. Açık VAE, barındırılan ve kendi kendine barındırılan iş akışları için gizli alanı standartlaştırması nedeniyle özellikle dikkat çekicidir.
Önemli olan şu: Dil ve gizli akış eşleştirmesini birleştirmek, daha güçlü bir istem takibi (böylece çok parçalı, kompozisyon talimatları öngörülebilir şekilde davranır), daha iyi tipografi ve birden fazla referansla hem oluşturmayı hem de düzenlemeyi destekleyen tek bir mimari sağlar. İçerik oluşturucular için bu, karmaşık talimatlar ve karışık girdiler (metin + görseller) için daha güvenilir çıktılar anlamına gelir.
FLUX.2 API'sine nasıl erişebilirim?
Ortamı hazırlayın
CometAPI'ye kaydolun ve giriş yapın, profil panelinizden API anahtarınızı alın. İdeal olarak, bir geliştirici olarak API konusunda biraz bilgi sahibi olmanız gerekir (bu konuda size yardımcı olacağız, lütfen endişelenmeyin).
Ayrıca istediğiniz istek yöntemini ve uygun Flux.2 modelini seçmeniz gerekecektir.
Hangi uç noktalar, kimlik doğrulaması gereklidir?
Replicate Predictions API, Black Forest Labs'ın çeşitli FLUX modellerini kullanarak standart Replicate formatı aracılığıyla yüksek kaliteli görüntüler oluşturmanıza olanak tanır. Bu API, hızlı prototiplemeden profesyonel düzeyde görüntü oluşturmaya kadar farklı kullanım durumları için optimize edilmiş kapsamlı bir FLUX model varyantları yelpazesini destekler. Kullanıcılar, URL yolundaki model adını (https://api.cometapi.com/replicate/v1/models/{models}/predictions) değiştirerek farklı modeller arasında sorunsuz bir şekilde geçiş yapabilir ve bu da API'yi çeşitli yaratıcı ve ticari uygulamalar için esnek hale getirir.
Kuyrukluyıldız API'si https://api.cometapi.com/flux/v1/{model} altında yönetilen uç noktaları açığa çıkarır ve görüntü oluşturma ve düzenleme için uç noktaları flux-2-pro, flux-2-flex ve flux-2-flex gibi adlandırır. İstekler için bir API anahtarı gereklidir. x-key Başlık .
Model ailesi ve hesaplama uzlaşmaları
- FLUX.2 (açık ağırlıklar) — Yerel kontrole, araştırma deneylerine veya kendi altyapınızda çıkarım yapmaya ihtiyaç duyduğunuzda kullanın. Dev, açık kaynaklıdır (32B) ve keşifsel araştırmalar ve ince ayarlar için mükemmeldir. Daha yapılandırılabilirdir, 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 süresi, tutarlı ve hızlı uyumluluk, hızlı çıktı için ayarlanmıştır ve 8 adede kadar API referans görüntüsünü (API üzerinden toplam 9 MP) destekler. Bunu yüksek hacimli düzenlemeler için ve güvenilirlik ve öngörülebilir fiyatlandırmaya ihtiyaç duyduğunuzda kullanın.
- FLUX.2 (yönetilen + kontrol edilebilirlik) — Düşük seviyeli üretim kontrollerini açığa çıkarır (örn.
steps,guidance) ve daha yüksek gecikme ve maliyete katlandığınızda daha fazla referansı (10'a kadar) ve biraz daha yüksek kalite/ayrıntıyı destekler. Son yaratıcı kontrole (tipografi doğruluğu, kesin renkler veya son derece ayrıntılı kompozisyon ayarlamaları) ihtiyaç duyduğunuzda Flex'i kullanın.
Prototip açık dev veya düşük maliyetli başına planlayın, ardından geçiş yapın başına ölçek veya Esnek Son derece kontrollü son renderlar için.
FLUX.2 API'sini nasıl kullanırım?
İstek yaşam döngüsü (görev + anket modeli)
Düzenleme/oluşturma taleplerine verilen yanıtlar görev nesneleri içeren bir polling_url ve id; bir istek oluşturursunuz ve ardından imzalanmış sonuç URL'sini almak için anket yaparsınız (veya web kancaları kullanırsınız). İmzalanmış URL'ler kısa ömürlüdür (genellikle ~10 dakika), bu nedenle çıktıları hemen alın.
Barındırılan API, eşzamansız görev modelini takip eder:
- Bir nesil isteğini GÖNDER → bir tane döndürür
task idvepolling_urlartı tahminicost. - Anket yapın
polling_urlkadarstatus == "Ready", ardından görüntü sonucunu alın (genellikle base64 veya barındırılan bir URL).
Örnek: Python (istekler) — 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 → anket veya webhook), yönetilen uç noktalar için birincil eşzamanlı/eşzamansız akıştır.
Görüntü Düzenleme — minimal örnek (giriş URL'si ile 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": "https://example.com/my-photo.jpg",
"width": 2048,
"height": 1536
}'
Çoklu referans düzenlemesi için şunu kullanın: input_image, input_image_2, input_image_3, … (Pro, API aracılığıyla en fazla 8 referansı destekler; Flex en fazla 10; Dev, belleğe bağlı olarak en fazla ~6 referansı destekler).
Hangi temel parametreleri göndermeliyim?
Önemli istek gövde alanları (görüntü düzenleme/oluşturma) şunları içerir:
guidancevesteps— ince ayarlı kontrole izin verir.prompt(dize) — 32K'ya kadar belirteç; ayrıntılı doğal dil veya yapılandırılmış JSON.input_image(dize) — düzenlemeler için gereklidir (URL veya base64).input_image_2...input_image_9— çoklu referanslı görüntüler.width/height— 16'nın katları; çıkış maksimum 4MP.seed— tekrarlanabilirlik için tam sayı.safety_tolerance— ılımlılık düzeyi.
Profesyonel metinden resme dönüştürme için FLUX.2 Pro'yu nasıl kullanabilirim?
FLUX.2 Pro, güvenilir ve yüksek kaliteli çıktılar için ayarlanmıştır. Tutarlı marka düzeyinde sonuçlara, hızlı geri dönüşe ve kurumsal SLA'lara ihtiyacınız olduğunda kullanın.
İş akışı tarifi — üretim görüntüleri
- Önişlem istemleri: Kısa bir "amaç" satırı ve yapılandırılmış bir nitelikler bölümü (aydınlatma, lens, ruh hali, marka renkleri için renk onaltılık kodları) tutun. FLUX.2, marka paletlerini korumaya yardımcı olmak için onaltılık renk yönetimini destekler.
- Muhafazakar varsayılanlarla başlayın: 30-50 arası adımlar ve 6-9.0 arası rehberlik ölçeği; ayrıntılar için adımları artırın, sonuçların istemlere daha sıkı uymasını sağlamak için rehberliği artırın.
- Tohumları + kesin örneklemeyi kullanın A/B testinde tekrarlanabilirlik için.
- Çoklu deneme örneklemesi için Pro uç noktasını kullanın: N varyasyonunu paralel olarak isteyin ve en iyisini seçin — manuel hiperparametre ayarından daha ucuz ve daha hızlı.
- Son işlem: Deterministik bir işlem hattında gürültü giderme, küçük ton eşleme veya vektör tarzı rötuşlar. Yerel çıktıdan daha yüksek bir değere ihtiyacınız varsa küçük bir GAN veya süper çözünürlüklü bir 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 nedenle müşteriye dönük varlıklar için mantıklı bir varsayılan değerdir.
Görüntü oluşturmaya yönelik en iyi ipuçları
1. Yapılandırılmış yönlendirme üretimde kazanç sağlar. İstemleri önceliğe göre düzenleyin: konu → eylem → stil → bağlam. Birçok görüntüde kesin bir kompozisyona ihtiyaç duyduğunuzda JSON istemlerini (sahne, nesneler, kamera, aydınlatma, renk paleti) kullanın. Örnek JSON şeması kullanımı (sahte):
{
"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: Geçiş seed Daha sonra yeniden üretmek için. İzlenebilirlik için bir katalog eşleme istemi + tohum → görüntü tutun.
3. Toplu işlem ve orkestrasyon: Büyük üretim süreçleri için, Pro'ya paralel olarak birçok istek gönderin, ancak kısıtlamayı önlemek için hız sınırı koyun; öngörülebilir gecikme için Pro uç noktasını tercih edin. İmzalı sonuçları hazır olduğunda hızlıca indirmek için iş kuyruklarını ve çalışan havuzlarını kullanın.
4. Ölçülülük ve güvenlik: Kullanım safety_tolerance Moderasyon sıkılığını kontrol etmek için. Pro uç noktaları, kullanım politikalarını ve içerik moderasyon bağlantılarını içerir; yayınlamadan önce sunucu tarafı kontrollerini entegre edin.
5. Son İşleme: Profesyonel çıktılar yüksek kalitededir, ancak zaman zaman küçük rötuşlara ihtiyaç duyarlar. Boru hattınıza otomatik bir son işlem adımı (kırpma, renk derecelendirme, birleştirme) ekleyin ve markaya duyarlı varlıklar için insan incelemesi yapın.
FLUX.2 Flex uç noktasıyla çıktıları nasıl özelleştirebilirim?
Flex, “cerrahi araç” çeşididir: Çıkışı hassas bir şekilde şekillendirmek için ayar adımlarını, rehberliği, negatif istemleri, döşeme boyutlarını ve referans sayılarını ayarlayın.
Flex'i ne zaman seçmelisiniz?
- Hassas tipografik görselleştirmeye (UI mockup'ları, etiketler) ihtiyacınız var.
- Poz ve ışık üzerinde kontrol sağlayarak birden fazla referansı birleştirmelisiniz.
- Gelişmiş istem tekniklerini (yapılandırılmış istemler, kısıtlama zincirleri) deniyorsunuz.
Örnek — Flex kontrol tuşları ve etkileri
steps— daha fazla adım = daha ince ayrıntı (gecikme pahasına).guidance_scale— daha yüksek = metin istemine daha yakın, daha düşük = daha fazla yaratıcılık.negative_prompt— öğeleri açıkça kaldırın (örneğin, "filigran yok, ekstra parmak yok").tile_size/tiled_inference— çok yüksek çözünürlüklü üretim için, hız karşılığında hafızayı takas etmek üzere çıkarım alanını döşeyin.reference_weights— bazı uç noktalar, hangi görüntünün pozu yönlendirdiğine ve stile göre referansları ağırlıklandırmanıza olanak tanır.
Pratik ipucu: Karmaşık kompozisyonlar için, kompozisyonu doğrulamak üzere kısa ve düşük kılavuzlu bir önizleme çalıştırın, ardından daha fazla adım ve daha yüksek kılavuzla ölçeklendirin. Bu iki geçişli teknik, hassas nihai çıktılar sağlarken maliyeti de düşürür.
Örnek: Adımlar ve kılavuzla esnek istek
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
}'
Bahşiş: Son yaratıcı onaylar için Flex'i, büyük ölçekli ve daha hızlı süreçler için ise Pro'yu kullanın. Flex, tipografi ve mikro detay görevleri için gözle görülür şekilde daha kontrol edilebilirdir.
Üretim kullanımına yönelik en iyi uygulamalar
Aşağıda FLUX.2'yi büyük ölçekte entegre etmek için savaşta test edilmiş modeller ve pragmatik tavsiyeler yer almaktadır.
1) Megapikselleri ve önbelleği takip ederek maliyeti kontrol edin
FLUX.2 faturalandırması megapiksellere dayanmaktadır giriş + çıkışYüksek hacimli üretim için daha küçük önizleme render'larını (düşük çözünürlüklü hızlı adımlar) tercih edin ve yalnızca daha yüksek MP son render'larına ilerleyin. İşlenmiş varlıkları önbelleğe alın (veya farkları depolayın), böylece aynı işleri tekrar işlemezsiniz. Her zaman yüzeye çıkın. cost cevaplarda ve istek başına günlüğe kaydedin.
2) Katmanları akıllıca kullanın: Önizleme ve son işleme ayrımı
- Prototipleme veya birçok varyant için hızlı, düşük adımlı Pro render'ları çalıştırın.
- Doğruluğun önemli olduğu nihai onaylı çıktılar için Flex veya yüksek MP Pro çalışmalarını kullanın. Bu hibrit yaklaşım, verimlilik ve nihai görüntü kalitesini dengeler.
3) İstem mühendisliği → yapılandırılmış istemler ve JSON
FLUX.2'nin avantajlarından yararlanın yapılandırılmış JSON istemi Belirleyici kompozisyona (sahne nesneleri, kamera, pozlar, onaltılık renk örnekleri) ihtiyaç duyduğunuzda. Bu, yinelemeli komut döngülerini azaltır ve daha tekrarlanabilir gruplara yol açar. Cloudflare örnekleri, çok parçalı formlara gömülü JSON komutlarını gösterir.
4) Tohum + yeniden üretilebilirlik için versiyonlama
Tekrarlanabilir sonuçlara ihtiyacınız olduğunda, bir seed ve model sürümünü/zaman damgasını meta verilere kaydedin. Belirleyici varlık hatları için bir bildirim tutun: komut istemi, başlangıç noktası, model varyantı, çözünürlük, referans görüntü karmaları. Bu, izlenebilirliği ve geri alma seçeneklerini iyileştirir.
Sonuç
FLUX.2, "etkileyici demo" ile "üretim yaratıcı aracı" arasındaki boşluğu kapatmayı hedefliyor. Çoklu referans düzenleme, yüksek çözünürlüklü çıktılar ve barındırılan bir dizi uç nokta (artı açık çıkarım kodu ve niceliksel tüketici yapıları) ile ekiplere birçok pratik seçenek sunuyor: araştırma ve özelleştirme için yerel olarak çalıştırın veya kararlı üretim hatları için barındırılan Pro/Flex uç noktalarını kullanın.
Geliştiriciler erişebilir Flux.2 Geliştirme API'si, Flux.2 Flex API ve Flux.2 Pro API CometAPI aracılığıyla. Başlamak için, CometAPI'nin model yeteneklerini keşfedin Oyun Alanı ve danışın API kılavuzu Ayrıntılı talimatlar için. Erişimden önce, lütfen CometAPI'ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. IleetAPI Entegrasyonunuza yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat teklif ediyoruz.
Gitmeye hazır mısınız?→ Bugün CometAPI'ye kaydolun !
Yapay zeka hakkında daha fazla ipucu, kılavuz ve haber öğrenmek istiyorsanız bizi takip edin VK, X ve Katılın!