API

GPT Image 2.5 API

Bild

Die GPT Image 2.5 API bringt OpenAIs fortschrittlichste Modelle zur Bildgenerierung und Bildbearbeitung in Ihre Anwendung. Erstellen Sie Bilder aus Text oder bearbeiten Sie Referenzbilder mit flexiblen Seitenverhältnissen und Ausgaben in 1K, 2K oder 4K. Wählen Sie flare für schnelle, hochwertige Alltagsbilder oder sunburst für anspruchsvolle kreative Aufgaben und präzise Bildbearbeitung.

Autorisierungen

Bearerstringheadererforderlich

API-Schlüssel zur Autorisierung von Anfragen

Body

application/json

modelstringerforderlich

gpt-image-2-5

input.promptstringerforderlich

Beschreiben Sie das gewünschte Bild, einschließlich Motiv, Komposition, Stil und Beleuchtung. Geben Sie bei der Bildbearbeitung an, was geändert und was in den Referenzbildern beibehalten werden soll. Führende und nachfolgende Leerzeichen werden entfernt.

input.modestringoptional

Wählen Sie die GPT Image 2.5 Variante. flare ist der Standardmodus und priorisiert Geschwindigkeit für hochwertige Alltagsbilder und schnelle Iterationen. sunburst priorisiert anspruchsvolle Qualitätsanforderungen und Bearbeitungspräzision und eignet sich besonders für genaue Änderungen an Referenzbildern.

Beide Modi unterstützen Text-zu-Bild und Bildbearbeitung. Lassen Sie input.images für die Generierung aus Text weg oder geben Sie Referenzbilder zur Bearbeitung an. Verwenden Sie beim Vergleich dieselbe Beschreibung, dieselben Referenzen, dasselbe Seitenverhältnis und dieselbe Auflösung.

Standard: flare

flaresunburst

input.imagesstring[]optional

Optionale URLs für Referenzbilder. Verwenden Sie ausschließlich öffentlich zugängliche HTTPS-URLs. Für die Bildgenerierung aus Text kann das Feld weggelassen werden.

input.aspect_ratiostringoptional

Verhältnis von Breite zu Höhe des Ausgabebildes. Mit auto wählt das Modell eine passende Komposition. Wählen Sie ein aufgeführtes Verhältnis, um das Format festzulegen, etwa 1:1 für quadratische Bilder, 9:16 für Hochformat oder 16:9 für Querformat.

Standard: auto

auto1:12:33:23:44:39:1616:921:9

input.resolutionstringoptional

Auflösungsstufe der Ausgabe. Verwenden Sie die kleingeschriebenen Werte 1k, 2k oder 4k für die entsprechende Stufe. Legen Sie dieses Feld ausdrücklich fest, wenn eine bestimmte Ausgabeauflösung erforderlich ist.

Standard: 2k

1k2k4k

Anfragebeispiele

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-5",
  "input": {
    "prompt": "Ein cineastisches Produktfoto einer futuristischen Kamera in Bananenform"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

Fragen Sie diesen Endpunkt mit der zurückgegebenen Aufgaben-ID ab, bis die Aufgabe abgeschlossen ist oder fehlschlägt. Wir empfehlen eine Abfrage alle 5 Sekunden, um den aktuellen Status zu prüfen.

POST /api/v1/check

{
  "task_id": "task_example"
}

Antwort

Aufgabenstatus von POST /api/v1/check. Die folgenden IDs, URLs und Zeitstempel dienen als Beispiele.

idstringerforderlich

Aufgabenkennung in data.id, identisch mit task_id in der Statusabfrage.

statusstringerforderlich

completed bedeutet, dass die Generierung erfolgreich war und data.data die Ergebnisse enthält. Bei anderen Statuswerten ist data.data null.

failed_reasonstringoptional

Wird nur bei status failed zurückgegeben und erklärt die Fehlerursache. Bei completed und processing fehlt dieses Feld.

Abgeschlossen · completed

Download-URLs stehen in data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Andere Statuswerte

Bei processing oder failed ist data.data null. Dieses Beispiel zeigt failed: Nur failed enthält failed_reason. Bei processing weiter abfragen, bei failed aufhören.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Credit-Verbrauch

Verbrauchte Credits für eine Anfrage, die ein Bild erzeugt.

Verbrauchte Credits für eine Anfrage, die ein Bild erzeugt.
Auflösung	1K	2K	4K
Ein Bild	12	36	50

Optionale Parameter weggelassen: 5 Credits

Geben Sie die aufgeführten input-Parameter ausdrücklich an, um den jeweiligen Tarif zu nutzen. Anfragen mit mehreren Ausgabebildern können mehr Credits verbrauchen.

Das Feld credits in der Antwort von POST /api/v1/create zeigt die für die Aufgabe abgebuchten Credits.