Entwicklerreferenz

GPT Image 2.6 API-Dokumentation

Erstelle einen API-Schlüssel, sende eine Anfrage zur Bilderstellung und frage die Aufgabe ab, um dein Bild abzurufen.

API-Schlüssel erstellen

Melde dich an und erstelle in deinem Konto einen Schlüssel. Setze GPT_IMAGE_API_KEY in deiner Serverumgebung auf diesen Schlüssel, bevor du die Beispiele ausführst.

API-Schlüssel verwalten

Bewahre deinen Schlüssel auf deinem Server auf. Beide Endpunkte verwenden deinen Benutzer-API-Schlüssel über Authorization: Bearer und benötigen kein Browser-Cookie.

Anfragen zur Bilderstellung verbrauchen Credits deines Kontos. Bei gleichen Einstellungen kosten Flare und Sunburst gleich viele Credits. Aktuelle Bildkosten ansehen

Anfrage zur Bilderstellung senden

POST /api/generate

Speichere das folgende JSON als request.json. Dieses Beispiel erstellt ein Bild aus Text. Für die Bearbeitung mit Referenzbildern ergänze das unten beschriebene Array images.

Anfragetext: `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "Eine blaue Keramiktasse auf einem Holztisch vor einem warmen Papierhintergrund.",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

Von deinem Server senden

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Bei erfolgreicher Übermittlung werden code 200, data.task_id, data.status mit dem Wert IN_PROGRESS und data.consumed_credits zurückgegeben. Speichere data.task_id für die Statusabfrage.

Anfragefelder

Feld	Bedeutung und zulässige Werte
`model`	Verwende gpt-image-2.6. Dieser Wert gilt auch, wenn das Feld fehlt.
`variant`	Optional: flare, sunburst. Standard: flare. Für Sunburst setze den Wert auf sunburst.
`prompt`	Erforderlicher Text mit 1 bis 20000 Zeichen nach Entfernen von Leerraum am Anfang und Ende.
`quality`	Optional: low, medium, high, xhigh, max. Standard: medium.
`resolution`	Optional: 1k, 2k, 4k. Standard: 1k.
`complexity`	Kompositionsplanung, optional: low, medium, high. Standard: high.
`output_format`	Optional: png, jpeg, webp. Standard: png.
`images`	Optionales Array mit bis zu 16 HTTP(S)-Bildadressen. Mindestens ein Referenzbild aktiviert die Bearbeitung; für die Bilderstellung aus Text lasse dieses Feld weg.

Aufgabe abfragen

GET /api/status

Setze TASK_ID auf die zurückgegebene data.task_id. Sende den Wert als Abfrageparameter task_id mit demselben Benutzer-API-Schlüssel.

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: Die Aufgabe läuft noch. Frage diesen Endpunkt erneut ab, um den Fortschritt zu prüfen.
SUCCESS: Die Adressen der erstellten Bilder stehen im Array data.response.
FAILED: Lies die Fehlerdetails in data.error_message, bevor du entscheidest, ob du eine neue Anfrage sendest.

Beispiel einer abgeschlossenen Aufgabe

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

Die Werte in spitzen Klammern stehen für die Aufgaben-ID und Bildadresse, die deine Anfrage zurückgibt.