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.
CometAPI üzerinde oluşturma ve düzenleme için FLUX 3 Image'i kullanın. Görüntü parametrelerini, asenkron görev yönetimini, istem örneklerini ve fiyatlandırmayı öğrenin.
Deon GoodwinAI model ve API araştırma ekibi
Güncellendi Nov 11, 2026 14 dk okuma
Önce yanıt
CometAPI üzerinde oluşturma ve düzenleme için FLUX 3 Image'i kullanın. Görüntü parametrelerini, asenkron görev yönetimini, istem örneklerini ve fiyatlandırmayı öğrenin.
Hızlı bir yanıt için bu özeti kullanın, ardından bağlam, örnekler ve uygulama ayrıntıları için kılavuzu okuyun.
FLUX 3 Image ile ürün fotoğrafları, posterler ve referans tabanlı düzenlemeler oluşturun; CometAPI üzerinden flux-3-image olarak sunulur ve istek başına $0.0384’ten başlayan fiyatlarla kullanılabilir. Bu rehber, görsel ayarlarını seçme, bir isteği hazırlama, eşzamansız bir işi yönetme ve tamamlanan görseli inceleme adımlarında size yol gösterir. Bir CometAPI hesabına, bir API anahtarına ve hesabınız için sağlanan FLUX 3 Image istek yapılandırmasına ihtiyacınız olacak.
Key Takeaways
Yeni kompozisyonlar için metinden görsele, ürün veya özne tanınabilir kalmalıysa referans yönlendirmeli düzenleme kullanın.
Daha büyük nihai görselden önce bileşimi gözden geçirmek için küçük bir taslak üretin.
CometAPI kimlik bilgilerini ve modele özel istek şemasını kullanın; BFL-yerel anahtarlar ve örnekler ayrı bir entegrasyona aittir.
Netlik, kaynak ataması ve güncel API terminolojisi açısından gözden geçirildi.
Uygun CometAPI ücretinden maliyeti tahmin edin, ardından kabul edilen teslimat başına harcamayı ölçün.
Toplu çalıştırmadan önce bir gönderim, sonuç alma, indirme ve görsel inceleme döngüsünü tamamlayın.
What Is FLUX 3 Image API?
FLUX 3 Image, durağan görselleri oluşturmak ve gözden geçirmek için Black Forest Labs’in modelidir. Bir metin istemi yeni bir sahneyi tanımlar; referans görseller korunacak, birleştirilecek veya değiştirilecek görsel materyali sağlar. Bir e-ticaret ekibi için bu, bir ürün sahnesinin brieften geliştirilmesi ve ardından onaylı bir ürün fotoğrafının çevresini değiştirirken yeniden kullanılması anlamına gelebilir.
İstemi yazmadan önce bir iş akışı seçin. Yeni bir görsel için özneyi, ortamı, ışığı ve kadrajı belirtin. Bir düzenleme için kaynak görseli tanımlayın, değişikliği adlandırın ve hangi ayrıntıların bozulmadan kalması gerektiğini söyleyin. Birden fazla referansla yapılan bir kompozisyon için her birine bir rol atayın; böylece ürün kimliği ve görsel stil çatışmaz.
FLUX 3 Image Specifications and API Parameters
Aşağıdaki ayarlarla görselinizi planlayın. Model kontrolleri BFL FLUX 3 Image API referansı ile uyumludur; kimlik doğrulama ve istek yönlendirme CometAPI entegrasyonunuzu takip eder. CometAPI FLUX 3 Image rotanızın kabul ettiği alan adlarını kullanın.
Boyutları üç yoldan biriyle seçin: bir çözünürlük katmanı artı en-boy oranı, kesin bir tuval için width artı height veya bir düzenleme için match_input. Üretimden sonra kadraj ve ayrıntıları karşılaştırabilmek için orijinal referansı elinizin altında bulundurun. Yerel uç nokta desteklenmeyen alanları reddeder; çağırdığınız rotanın şemasını kullanın.
FLUX.2 vs FLUX 3 Image
FLUX 3 Image’ı değerlendirirken mevcut FLUX.2 entegrasyonunuzu karşılaştırma temeli olarak koruyun. Aynı brieflere ve referans varlıklara her iki iş akışında da çalıştırın, ardından kabul edilen çıktıları, geri dönüş süresini ve toplam maliyeti karşılaştırın.
How Do You Generate an Image with FLUX 3 Image API in CometAPI?
1. Prerequisites
CometAPI’ye kaydolun ve bir API anahtarı oluşturun.
Ortam değişkenini ayarlayın:
export COMETAPI_KEY="your_cometapi_key"
2. Endpoint
POST https://api.cometapi.com/flux/v1/flux-3-image
Kimlik doğrulama Bearer belirteci (CometAPI stili) kullanır. İstekler varsayılan olarak eşzamansızdır.
3. Basic text-to-image example (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
status "Ready" olana dek yoklayın. Görsel URL’si result.sample içinde görünür (hemen indirin; imzalı URL’ler geçicidir).
Aynı istekte eşzamanlı bekleme için gövdeye "async": false ekleyin (bağlantıyı açık tutun; istemci zaman aşımını cömert tutun).
5. Python example (submit + poll)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image, aynı uç noktada saf metinden görsele de düzenleme/çoklu referansı da destekler — sadece images ekleyin ve bunların nasıl kullanılacağını istemde açıklayın (ayrı bir “mode” alanı yoktur).
Alternative: OpenAI-compatible route
Birleşik görseller uç noktasını model kimliği ile de deneyebilirsiniz:
POST https://api.cometapi.com/v1/images/generations
(Yerel `/flux/v1/...` tam FLUX 3 parametreleri için tercih edilir.)
### Tips
* Güncel erişimi ve kesin fiyatlandırmayı [CometAPI Flux 3 Image model sayfasında](https://www.cometapi.com/models/flux/flux-3-image/) kontrol edin.
* `result.sample` URL’sini daima hızlıca indirin.
* En güncel parametre listesi veya oyun alanı örnekleri için CometAPI’nin Flux dokümanlarına ve Black Forest Labs’in resmi FLUX 3 Image referansına bakın.
Bu akış, CometAPI’nin kimlik doğrulaması ve birleşik altyapısı kullanılırken resmi BFL akışını yansıtır.
## How to Prompt FLUX 3 Image? Examples
### Example: Product Photography Prompt
İlk ürün fotoğrafçılığı testi için bu istemi kullanın.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
CometAPI isteğinizdeki prompt değerini bu brief ile değiştirin ve rotanızın beklediği istek gövdesini koruyun. 4:5 tuval, dikey ürün yerleşimine uygundur. Rotanız yerel boyut kontrollerini kabul ediyorsa 1024 × 1280 tam 4:5 seçeneklerinden biridir; iki değeri birlikte sağlayın.
Küçük bir taslakla başlayın ve şişe siluetini, etiketi, yansımaları ve ekstra nesneleri kontrol edin. Tam ürün kimliği önemliyse, metin tabanlı bir istemin ürünü birebir yeniden oluşturmasını beklemek yerine bir ürün referansı kullanın. Değişiklik yapmadan önce istemi ve çıktı ayarlarını kaydedin.
### Example: Typography and Poster Layout
Başlık metni açıkça belirtilmiş poster istemi.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Bu brieften komut olarak CometAPI isteğinizde yararlanın ve dikey bir tuval seçin. Önce başlık konumunu ve karakter düzenini kontrol etmek için bir taslak oluşturun, ardından nihai çalışma için çıktı boyutunu artırın.
Harf doğruluğunu ölçülebilir bir kabul koşulu olarak ele alın. Nihai çözünürlükteki çıktıda her harfi ve noktalama işaretini gözden geçirin; etkileyici galeri görselleri, sizin özel marka metninizde sıfır hata garantilemez.
## How to Edit Images with References
Bir düzenlemede, hem istediğiniz değişikliği hem de korunacak ayrıntıları açıklayın. Yerel FLUX 3 Image API referansları images içinde alır; bunları CometAPI örneğinizdeki ilgili giriş alanına eşleyin. Ürün referansını ilk sıraya koyun ve bu sırayı istemde tutarlı kılın.
### Single-Image Editing: Change the Background, Preserve the Product
edit.py’yi submit.py, poll.py ve download.py ile aynı dizinde bulundurun. PRODUCT_IMAGE_URL değerini herkese açık erişilebilir bir HTTPS ürün fotoğrafına ayarlayın, ardından python edit.py çalıştırın. Aşağıdaki örnek, yerel images dizisini kabul eden bir rota gerektirir. Çakışan kaynak-görsel alanları olmayan bir düzenleme istek gövdesi kullanın; CometAPI örneğiniz farklı bir giriş alanı kullanıyorsa eşlemeyi değiştirin. Kaydedilmiş bir düzenleme görevini sürdürmek için python poll_download.py editing-task.json çalıştırın.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Okunabilir bir etiket ve net bir siluete sahip keskin bir ürün fotoğrafı seçin. Bunu CometAPI rotanızın kabul ettiği görsel giriş biçiminde gönderin. Rota yerel resolution ayarını destekliyorsa, modelin düzenleme sınırlarına tabi olarak match_input kullanarak referansın kadrajını ve boyutunu koruyun.
[BFL galerisi](https://bfl.ai/models/flux-3-image) iki dalgıç ekleyerek yerelleştirilmiş bir düzenlemeyi gösterir. Bu resmi önce-sonra varlıklar neyin incelenmesi gerektiğini örnekler; bu makale için CometAPI isteği çalıştırılarak alınmış çıktılar değildir.
BFL resmi düzenleme örneği, önce: tek bir dalgıç bulunan orijinal sualtı sahnesi.
BFL resmi düzenleme örneği, sonra: sahneye iki dalgıç eklendi. Yeni öznelerin yanı sıra değişmeyen arka planı da inceleyin.
### Multi-Image Reference Editing: Combine Style and Product Identity
Ürünü önce, aydınlatma/stil referansını ikinci sıraya koyun. PRODUCT_IMAGE_URL ve STYLE_IMAGE_URL değerlerini ayarlayın, aşağıdaki kodu multi_edit.py olarak üç istemci dosyasının yanına kaydedin ve python multi_edit.py çalıştırın. Bu örnek, images içinde en az iki referansı kabul eden bir rota gerektirir. Çakışan kaynak görsel alanları olmayan bir düzenleme istek gövdesiyle başlayın. Kaydedilmiş bir işi python poll_download.py multi-edit-task.json ile sürdürün.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Her iki referansı da modele özgü CometAPI biçimini kullanarak ekleyin. Önce ürünün kimliğinin korunup korunmadığını gözden geçirin; sonra ikinci referansın istenen ışık ve rengi katıp katmadığını değerlendirin. İstenmeyen nesneler veya yazılar da geliyorsa bu referansı sadeleştirin veya istemi daha açık hale getirin.
## How to Use Bounding Boxes for Layout Control
Şişe ve başlığın öngörülebilir bölgelere yerleşmesi gerekiyorsa kutular kullanın. Her öğe için bir kimlik içeren bir sahne başlığı yazın ve ardından isteme bir JSON dizisi ekleyin. BFL’nin formatı 0–1000 ızgarasında [üst, sol, alt, sağ] sıralı bbox kullanır; kutular ayrı bir API alanında değil, istemin içinde yer alır.
Aşağıdaki örnek şişenin üstünde bir başlık için boşluk ayırır. request.json içinde dikey bir çıktı ayarı koruyun ve bu dosyayı layout.py olarak submit.py’nin yanına kaydedin. python layout.py çalıştırın, ardından python poll_download.py layout-task.json. Bu yerleşim söz dizimini destekleyen bir rota kullanın; şişe ve başlığın hedeflenen bölgeleri kaplayıp kaplamadığını kontrol etmek için sonucu inceleyin.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
En-boy oranını yerleşimle tutarlı tutun. Kutular yerleşimi yönlendirir; bir nesneyi sert bir sınıra kırpmaz. Kaydedilen görselde başlık yazımı ve boşlukları inceleyin; tam tipografi gerektiğinde son marka yazısını bir tasarım aracında ekleyin.
## How Much Does FLUX 3 Image API Cost?
CometAPI, FLUX 3 Image’ı [istek başına $0.0384’ten başlayan fiyatlarla](https://www.cometapi.com/models/flux/flux-3-image/) sunar (9 Kasım 2026). İlk bütçe için bu başlangıç oranını kullanın, ardından seçtiğiniz yapılandırma için gösterilen oranı uygulayın. Aşağıdaki örneklerde her ücretlendirilen isteğin başlangıç oranını kullandığı varsayılmıştır.
| Ücretlendirilen istek | Varsayılan oran / istek | Örnek maliyet |
| --------------------- | ----------------------- | ------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Toplu işleme başlamadan önce seçilen yapılandırma ve hesap için oranı kontrol edin. Genel başlangıç fiyatı, her çözünürlük veya düzenleme seçeneğinin fiyatını belirlemez. Reddedilen yaratıcı denemeleri ve onaylanan çıktıları takip edin: 100 ücretli istek için $3.84 harcayıp 80 teslimatı onaylarsanız, kabul edilen teslimat başına API maliyeti $0.048 olur; insan incelemesi ve depolama hariç. Bu ölçülmüş bir kabul oranı değil, örnek bir hesaplamadır.
### Resolution Choices by Workflow
| İş akışı | İlk test | Onay kontrolü |
| ---------------------------- | -------------------------------------------- | -------------------------------------------------- |
| İstem keşfi | Desteklenen en küçük kullanışlı katman | Kompozisyon ve özne yerleşimi |
| E-ticaret ürün görselleri | Hedef kırpma ile bir taslak | Ürün geometrisi, etiketler ve kenar ayrıntısı |
| Kampanya veya editoryal iş | Önce taslak; yerleşim onayından sonra büyük çıktı | Teslim boyutunda tipografi ve ayrıntı |
| Referans tabanlı düzenlemeler| Kaynağa uygun desteklenen bir ayar | Değişmeyen bölgeler, ürün kimliği ve aydınlatma |
## When Should You Use FLUX 3 Video Instead?
FLUX 3 Image’ı ürün kahraman görseli, poster veya kampanya karesi gibi durağan varlıklar için kullanın. Teslimat hareket gerektiriyorsa, ayrı model kimliği flux-3 altında listelenen [CometAPI’de FLUX 3 Video](https://www.cometapi.com/models/flux-3/) seçeneğine bakın. [Video iş akışı](https://apidoc.cometapi.com/api/video/flux-3/create) video‑özel ayarlar ve ücretlendirme kullanır. Görsel ve video isteklerini ayrı tutun; süre, ses ve video kare kontrolleri durağan görsel isteğine ait değildir.
Her iki formatın da yer aldığı bir kampanya için önce durağan görsel kompozisyonunu onaylayın, ardından hareket brifini ayrı hazırlayın. Onaylı bir görseli kaynak materyal olarak yeniden kullanmadan önce video modelinin referans girdi gereksinimlerini kontrol edin.
## Conclusion
Tek bir ürün brief’i ve tek bir küçük görsel işiyle başlayın. Bunu CometAPI FLUX 3 Image rotanız üzerinden gönderin, görev kimliğini kaydedin, tamamlanan görseli alın ve ölçeklendirmeden önce sonucu inceleyin. Kesin bir tuval gerektiğinde width ve height kullanın veya desteklendiğinde referans düzenlemesi için match_input uygulayın. Bütçenizin kullanılabilir sonuçları yansıtması için toplam harcamayı onayladığınız görsel sayısıyla karşılaştırın.
## SEO Metadata
Meta title: FLUX 3 Image API Rehberi: Üretim, Düzenleme ve CometAPI
Meta description: CometAPI üzerinde üretim ve düzenleme için FLUX 3 Image’ı kullanın. Görsel parametreleri, eşzamansız iş yönetimi, istem örnekleri ve istek başına $0.0384’ten başlayan fiyatları öğrenin.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, FLUX 3 image editing, FLUX 3 pricing, reference image generation, FLUX.2 migration
URL slug: flux-3-image-api-guide
Yetenek / ayar
Ne kontrol eder
CometAPI ile nasıl kullanılır
Model kimliği
FLUX 3 Image; katalog kimliği flux-3-image
Hesap örneğinizdeki modele özel rota ve yönlendirme kuralını kullanın.
Üretim / istem
Sahne, kompozisyon veya düzenleme talimatı
Tek bir net özne ve tek bir hedef çıktı ile başlayın.
Referans görseller / yerel images
1–10 adet referans görselin sıralı listesi; yerel API’de HTTP(S) URL’leri veya base64 olarak sağlanır.
Ağ geçidinin alan adını, giriş biçimini ve referans sınırını teyit edin.
En-boy oranı / native aspect_ratio
Tuval oranları. Auto ile, istemde talep edilen oran önceliklidir; aksi halde düzenlemeler, ilk referansın kadrajını korur.
Teslimat formatı için bir oran seçin ve kabul edilen değerleri doğrulayın.
Çözünürlük / native resolution
Yerel katmanlar: 768sq, 1k (varsayılan), 1.5k, 2k ve 4k. Kesin boyutlar en-boy oranına bağlıdır.
Düzenlemelerde match_input ilk referansın boyutunu korur, daha büyükse 4 MP’ye düşürür; açık bir aspect_ratio en yakın katmanı seçer. Açık width ve height önceliklidir.
Kesin boyutlar / width + height
Her biri 256–6256 piksel olan iki tamsayı sağlayın. Çözünürlüğü ve aspect_ratio’yu geçersiz kılar. Toplam alan 16,822,272 piksel ile sınırlıdır; referans görseller kullanıldığında 4,194,304 pikseldir.
Sabit teslimat boyutu için açık boyutlar kullanın, örn. 1024 × 1280. CometAPI rotanızın bu yerel kontrolleri kabul ettiğini onaylayın.
Yerleşim kontrolü
Öğelerin yerleşimi için bounding-box yönlendirmesi
Tam konumlandırma gerektiğinde belgelenmiş yerleşim söz dizimini kullanın.
Hedefli düzenlemeler
Seçilen özne veya bölgelere yapılan değişiklikler
Değişmeden kalması gereken alanlarda kaynak ve sonucu karşılaştırın.
Boyut
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
Pratik değerlendirme
Kullanım durumu
Güçlü metinden görsele/düzenleme, aile varyantları
Ayrıntılı görsel kompozisyonu ve pikseli koruyan düzenlemeler
Aynı marka istemlerini karşılaştırın
Çözünürlük
Varyanta bağlı yüksek çözünürlüklü üretim
Açık 2K/4K yerel vitrin
İnce ayrıntıları tam yakınlaştırmada inceleyin
Düzenleme
Seçili varyantlarda çoklu referans yetenekleri
Yerelleştirilmiş düzenleme gösterimleri
Düzenlenmemiş alan sürüklenmesini ölçün
Maliyet
Varyant ve platforma göre değişir
Seçili yapılandırma için CometAPI fiyatlandırması
Kabul edilen görsel başına kıyaslayın
CometAPI erişimi
CometAPI üzerinden FLUX 2 PRO ve FLUX 2 MAX olarak mevcut
CometAPI üzerinden flux-3-image olarak mevcut
Üretim yönlendirmesini değiştirmeden önce modele özel isteği doğrulayın
Eşzamansız üretim: bir işi gönderin, görev kimliğini takip edin ve tamamlanan görseli alın.
Hesabınızın rotası belgelenmiş CometAPI FLUX görev sözleşmesini izliyorsa aşağıdaki Python şablonunu kullanın.
Fiyatlandırma
CometAPI fiyatlandırması istek başına $0.0384’ten başlar (9 Kasım 2026).
Aşağıdaki fiyat bölümünü örnek bir bütçe için kullanın; seçili yapılandırmayı doğrulayın.
Ek alanlar
Yerel ve ağ geçidi şemaları model nesillerine göre değişir
Yerel FLUX 3 Image width ve height kabul eder. Eski bir modelden seed veya input_image’ı yeniden kullanmayın; yerel referans girdileri için images kullanın ve CometAPI şemasını izleyin.
CometAPI ile FLUX 3 Image API nasıl kullanılır? - CometAPI
