GPT-Image-2 Görüntü Oluşturma

• Model: gpt-image-2
• Uç Nokta: POST https://apimaster.ai/v1/images/generations
• Mod: Asenkron — task_id döndürür, ardından görevi yokla
• Özellikler: Metinden görüntüye; en fazla 16 referans görseli ile görüntüden görüntüye (URL + base64 karışımı)

Yetkilendirme

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Gövde Parametreleri

Alan	Tür	Zorunlu	Notlar
model	string	evet	gpt-image-2
prompt	string	evet	Sahne açıklaması; güvenlik denetimi uygulanır
n	integer	hayır	Yalnızca 1 (sayısal, tırnak yok)
size	string	hayır	En boy oranı, varsayılan 1:1
resolution	string	hayır	1k / 2k / 4k, varsayılan 1k
image_urls	array	hayır	Referans görseller → görüntüden görüntüye
official_fallback	boolean	hayır	Resmi kanal yedekleme, varsayılan false

size değerleri

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21 veya 3840x2160 gibi piksel dizeleri.

çözünürlük (örnek pikseller)

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Tüm 15 oran 4K'yı destekler.

image_urls

• Maksimum 16 görsel
• Genel URL'ler ve base64 veri URI'leri karıştırılabilir
• Çıktı çözünürlüğünü takip etmek için size'ı atlayın; çıktı en boy oranını zorlamak için size'ı ayarlayın.

Örnekler

Minimum metinden görüntüye

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Yanıt Gönder

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	Anlamı
400	Geçersiz parametreler
401	Geçersiz API anahtarı
402	Yetersiz bakiye
429	Hız sınırı aşıldı

Görev Sonucunu Yokla

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Görsel URL'si: data.result.images[0].url[0]

durum	Anlamı
submitted	Gönderildi
processing	İşleniyor
completed	Tamamlandı
failed	Başarısız (hata mesajına bakın)

10–20s sonra yoklayın, her 3–5s. Toplu: POST https://apimaster.ai/v1/tasks/batch ile {"task_ids":[...]}.

Notlar

• Yalnızca asenkron — oluşturma yanıtında eşzamanlı görsel URL'si yok.
• En boy oranı için size'ı tercih edin; prompt'ta oranı tekrarlamaktan kaçının.
• Faturalama çözünürlük katmanına göredir; hesabınız için konsola bakın.

Resmi kanal ile karşılaştırma yapın.