GPT-Image-2 Bildgenerierung

• Model: gpt-image-2
• Endpoint: POST https://apimaster.ai/v1/images/generations
• Mode: Asynchron — gibt task_id zurück, dann Aufgabe abfragen
• Features: Text-zu-Bild; Bild-zu-Bild mit bis zu 16 Referenzbildern (URL + base64 gemischt)

Authentifizierung

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Body-Parameter

Feld	Typ	Erforderlich	Hinweise
model	string	ja	gpt-image-2
prompt	string	ja	Szenenbeschreibung; Sicherheitsmoderation wird angewendet
n	integer	nein	nur 1 (numerisch, keine Anführungszeichen)
size	string	nein	Seitenverhältnis, Standard 1:1
resolution	string	nein	1k / 2k / 4k, Standard 1k
image_urls	array	nein	Referenzbilder → Bild-zu-Bild
official_fallback	boolean	nein	Offizieller Kanal-Fallback, Standard false

size-Werte

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, oder Pixel-Strings wie 3840x2160.

Auflösung (Beispiel-Pixel)

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

Alle 15 Seitenverhältnisse unterstützen 4K.

image_urls

• Maximal 16 Bilder
• Öffentliche URLs und base64 data URIs können gemischt werden
• size weglassen, um der Eingabeauflösung zu folgen; size setzen, um das Ausgabe-Seitenverhältnis zu erzwingen

Beispiele

Minimales Text-zu-Bild

{
  "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"
  }'

Antwort bei Einreichung

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

HTTP	Bedeutung
400	Ungültige Parameter
401	Ungültiger API-Schlüssel
402	Unzureichendes Guthaben
429	Rate-Limit überschritten

Aufgabenstatus abfragen

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

Bild-URL: data.result.images[0].url[0]

status	Bedeutung
submitted	In Warteschlange
processing	In Bearbeitung
completed	Fertig
failed	Fehler (siehe Fehlermeldung)

Abfragen nach 10–20s, alle 3–5s. Batch: POST https://apimaster.ai/v1/tasks/batch mit {"task_ids":[...]}.

Hinweise

• Nur asynchron — keine synchrone Bild-URL in der Erstellungsantwort.
• Bevorzuge size für das Seitenverhältnis; vermeide doppelte Angabe im prompt.
• Abrechnung nach Auflösungsstufe; siehe Konsole für dein Konto.

Vergleiche mit offiziellem Kanal.