FLUX 3 Image API: 4K ve Çoklu Referans Rehberi

FLUX 3 Image artık Black Forest Labs'ın sahibi olduğu Replicate modeli ve çeşitli partner uç noktaları üzerinden kullanılabiliyor. Model, 4K çıktı üretebiliyor ve 10 adede kadar referansla düzenleme yapabiliyor. Ancak BFL'nin güncel resmi dokümantasyonu hâlâ FLUX 3 Video'ya odaklanıyor; görsel sağlayıcıları ise farklı istek şemaları, limitler ve ücretlendirme kuralları kullanıyor.

FLUX 3 Image API gerçekten kullanıma açık mı?

FLUX 3 Image API erişilebilir durumda; ancak “resmi” ifadesini doğru tanımlamak gerekiyor. En güçlü kanıt, Replicate üzerindeki Black Forest Labs mülkiyetindeki canlı black-forest-labs/flux-3-image listelemesi. Bu uç nokta görsel üretim isteklerini kabul ediyor, bir görsel gönderildiğinde düzenleme moduna geçiyor ve çözünürlük seçenekleri arasında 4k değerini sunuyor.

BFL'nin FLUX 3 yardım makalesi yalnızca video modelini anlatıyor; ayrı BFL mülkiyetindeki Replicate listelemesi ve partner uç noktaları ise görsel düzenleme desteğini doğruluyor.

Uç nokta ortaya çıkmadan önce Reddit kullanıcısı u/rerri, API öncelikli bir çıkış öngörmüştü:

“API-only Flux 3 Image launches first.” — u/rerri on r/StableDiffusion

Yayın süreci bu tahminle örtüşüyor; ancak API erişiminin açılması, açık ağırlıkların kullanıma sunulduğu anlamına gelmiyor.

4K ve çoklu referans düzenleme pratikte ne ifade ediyor?

FLUX 3 Image, 4k çıktı seçeneği sunuyor ve 10'a kadar referans görsel kabul ediyor. Ancak bu iki özellik, sonuçta her kimliğin, ürün detayının veya küçük metin satırının kusursuz korunacağını garanti etmiyor. Sağlayıcı sayfaları kontrolleri ve örnekleri yayınlıyor; bağımsız kalite skorları sunmuyor.

BFL mülkiyetindeki Replicate README'si 768sq, 1k, 1.5k, 2k ve 4k seçeneklerini listeliyor. Referans dosyaları JPEG, PNG, GIF veya WebP olabilir; en az 256 x 256 piksel olmalı ve 16 megapikseli aşmamalı. aspect_ratio: auto kullanıldığında düzenlemenin en-boy oranını ilk referans belirliyor.

fal düzenleme şeması benzer olsa da tamamen aynı değil. Uç nokta 1-10 URL veya data URI kabul ediyor, her girdiyi 4 megapiksel ile sınırlıyor, 512sq ile 4k arasındaki seçenekleri destekliyor ve 4K işlemlerinin birkaç dakika sürebileceği konusunda uyarıyor. Referans sırası anlam taşıyor: “image 1”, image_urls listesindeki ilk öğeyi ifade ediyor.

Çoklu referans düzenlemelerinde her girdiye tek bir rol verin: temel kompozisyon, özne kimliği, ürün veya stil. fal'ın kendi önerisi de her istekte tek bir düzenleme yapılması yönünde. “Image 1'i temel al; yalnızca şişeyi image 2'deki ürünle değiştir; kamera açısını, elleri, ışığı ve arka planı koru” gibi bir prompt, aynı anda kıyafeti, tipografiyi ve konumu da değiştiren karmaşık bir isteğe göre çok daha kolay denetlenir.

Kuyruk tabanlı pratik API iş akışı

Üretim ortamındaki FLUX 3 Image API iş akışını asenkron bir iş olarak tasarlamak gerekir. Uygulama, kalıcı girdi URL'lerini yüklemeli, kapsamı dar bir istek göndermeli, sağlayıcının istek kimliğini saklamalı, artan bekleme aralıklarıyla durumu sorgulamalı ve tamamlanan çıktıyı kendi depolama alanına kopyalamalı.

Aşağıdaki örnek, fal'ın dokümante ettiği uç nokta kimliğini ve istek alanlarını kullanıyor. Bu bir entegrasyon şablonudur; aşağıdaki isteğin bu inceleme sırasında çalıştırıldığı anlamına gelmez.

import os
import time
import requests

ENDPOINT = "https://queue.fal.run/blackforestlabs/flux-3/edit-image"
headers = {
    "Authorization": f"Key {os.environ['FAL_KEY']}",
    "Content-Type": "application/json",
}
payload = {
    "prompt": (
        "Use image 1 as the base. Replace only its package with the product "
        "from image 2. Preserve the hands, camera angle, shadows, and background."
    ),
    "image_urls": [
        "https://cdn.example.com/base.jpg",
        "https://cdn.example.com/product.png",
    ],
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "png",
    "safety_tolerance": 2,
}

submitted = requests.post(ENDPOINT, headers=headers, json=payload, timeout=30)
submitted.raise_for_status()
job = submitted.json()

status_url = job["status_url"]
response_url = job["response_url"]
while True:
    status = requests.get(status_url, headers=headers, timeout=30)
    status.raise_for_status()
    state = status.json().get("status")
    if state == "COMPLETED":
        break
    if state in {"FAILED", "CANCELLED"}:
        raise RuntimeError(status.text)
    time.sleep(2)

result = requests.get(response_url, headers=headers, timeout=30)
result.raise_for_status()
print(result.json())

Model sayfasından bağlantı verilen fal kuyruk dokümantasyonu ayrıca sync_mode seçeneğini sunuyor. Ancak 4K için kuyruklu çalıştırma daha güvenli varsayılan seçenek; çünkü oluşturma işlemi normal bir HTTP isteğinin zaman aşımından daha uzun sürebilir. Layer bu asenkron sözleşmeyi daha net tanımlıyor: gönderim HTTP 202, bir inference_id ve önerilen sorgulama aralığı döndürüyor. Layer ayrıca 24 saat boyunca yeniden kullanılabilen idempotency anahtarlarını destekliyor; bu da ağ yeniden denemelerinden sonra mükerrer ücretlendirmeleri önlemeye yardımcı oluyor.

Trafiği açmadan önce:

1. Bir kenarı 256 pikselin altında kalan görselleri reddedin ve seçilen sağlayıcının megapiksel sınırını uygulayın.
2. Dizi sırasını koruyun; prompt'ları image 1, image 2 ve benzeri ifadelerle oluşturun.
3. Sağlayıcı destekliyorsa benzersiz bir idempotency anahtarı kullanın; desteklemiyorsa yeniden denemeden önce isteği kalıcı olarak kaydedin.
4. Sorgulama süresini sınırlayın ve uygulama isteğini açık tutmak yerine beklemede durumunu gösterin.
5. Tamamlanan dosyaları kontrollü depolamaya kopyalayın; barındırılan sonuç URL'leri uygulamanın saklama politikasıyla örtüşmeyebilir.
6. Her iş için model kimliğini, sağlayıcıyı, çözünürlüğü, referans sayısını, belirtilen maliyeti, geçen süreyi ve moderasyon sonucunu kaydedin.

Maliyet ve kalite dengesine dürüstçe bakmak

Sağlayıcılar kontrol edilen sayfalarda çözünürlüğe göre eksiksiz bir fiyat tablosu yayınlamadığı için savunulabilir bir maliyet karşılaştırması yapmak mümkün değil. fal, 1K için promosyonlu olarak görsel başına $0.024 fiyat açıkladı; promosyon sonrasında bu ücretin $0.048'e çıkacağını belirtti. Ayrıca referans sayısının ücreti değiştirmediğini söyledi. Bu model sayfasında 2K ve 4K için kesin fiyatlar yer almadığından, 4K bütçesi 1K fiyatından türetilemez.

4K'nın her zaman en iyi seçenek olduğunu varsaymak yerine iki aşamalı bir politika uygulayın:

Yüksek çözünürlük piksel sayısını artırır; düzenleme doğruluğunu değil. 1K'daki kötü bir düzenleme, 4K'da yalnızca daha büyük bir hataya dönüşür. 4K'yı baskı, billboard tasarımları veya yoğun kırpmalar için kullanılacak onaylı düzenlemelerle sınırlayın.

Uygulama başlatılırken sağlayıcıya minimum geçerli bir test işi gönderin veya sağlayıcının fiyatlandırma yüzeyini sorgulayın; dönen ücreti kaydedin ve fiyat bilgisi yoksa ya da iş bütçesini aşıyorsa 4K'yı devre dışı bırakın. Layer'ın ilk yanıtında estimated_price_creative_units bulunabilir; ancak herkese açık model sayfasında bunun dolar karşılığı verilmemişti. Replicate'in alınan model sayfası girdileri belgeliyor, fakat sabit bir fiyat sunmuyordu. Bunlar kod içinde tahmin edilecek sayılar değil, yayına çıkmadan önce hesap panelinde çözülmesi gereken satın alma ve tedarik boşluklarıdır.

Uç noktayı operasyonel ihtiyaçlarınıza göre seçin

Sağlayıcı seçimini uygulamanızın ihtiyaç duyduğu sözleşme belirlemeli. Modelin sahibi olmak, şemaların birbiriyle uyumlu olduğu anlamına gelmez.

• Replicate: Kaynak ve sahiplik önceliğinizse, ayrıca yığınınız Replicate'in prediction iş akışını zaten kullanıyorsa BFL mülkiyetindeki listelemeyi tercih edin. Buradaki en geniş girdi sınırını, 16 MP'yi belgeliyor ve isteğe bağlı web/görsel grounding desteği içeriyor.
• fal: Net görsel düzenleme kontrolleri, kuyruk iş akışı ve görünür bir 1K fiyatı sizin için daha önemliyse partner düzenleme uç noktasını seçin. 4 MP girdi sınırı, daha erken küçültme yapmanızı gerektirir.
• Layer: Çalışma alanı organizasyonu, resmi bir HTTP 202 sözleşmesi, sorgulama ipuçları ve 24 saatlik idempotency desteği istiyorsanız Layer'ı tercih edin. Bütçe belirlemeden önce Creative Units değerinin dolara nasıl çevrildiğini doğrulayın.

Bir sağlayıcıyı alan adında veya depo isminde “FLUX3” kelimesi geçtiği için tanımlamayın. Model kimliğini, sahibi veya partner etiketini, güncel enum değerlerini, ticari koşulları ve başarıyla tamamlanan düşük maliyetli bir isteği doğrulayın. Arama sonuçlarında üst sıralarda yer alan Anil-matcha/Flux-3-Dev-API sarmalayıcısı kontrol sırasında görsel rotalarını hâlâ “coming soon” olarak etiketliyordu; BFL mülkiyetindeki Replicate rotası ve fal partner rotası ise çalışır durumdaydı.

Üretime çıkış kontrolü

FLUX 3 Image; 4K ve 10 adede kadar referans dahil olmak üzere kontrollü API testleri için uygun. Ancak üretime geçmeden önce seçilen uç noktanın aynı temsili düzenleme setini hem 1K'da hem de final çözünürlükte başarıyla işlediğinden emin olun.

Pratik öneri şu: önce 1K düzenlemeyi kullanıma açın, fiyat teklifi ve gecikme verilerini kaydedin; 2K veya 4K'yı yalnızca onaylanmış final çıktılar için etkinleştirin. Böylece yeni modelin dokümante edilmiş en güçlü yeteneklerinden yararlanırken yüksek çözünürlük kalitesi veya maliyeti hakkında doğrulanmamış varsayımlara bel bağlamazsınız.

İlgili içerikler

• FLUX 3 ürün incelemesi
• En ucuz görsel üretim API'leri karşılaştırması