API

Nano Banana 2.1 API

Bild

Die Nano Banana 2.1 API liefert schärfere Bilder und ermöglicht präzisere Bearbeitung. Erstelle Bilder aus Textprompts oder bearbeite Referenzbilder mit flexiblen Seitenverhältnissen und einer Ausgabeauflösung von bis zu 4K. Integriere die API, um deine Anwendung um hochwertige Bildgenerierung und Bildbearbeitung zu erweitern.

Autorisierungen

Bearerstringheadererforderlich

API-Schlüssel zur Autorisierung von Anfragen

Body

application/json

modelstringerforderlich

nano-banana-2-1

input.promptstringerforderlich

Beschreiben Sie das zu erstellende Bild oder die gewünschten Änderungen an Ihren Referenzbildern. Leerzeichen am Anfang und Ende werden entfernt.

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

Seitenverhältnis der Ausgabe (Breite zu Höhe). Mit Auto wählt das Modell selbst.

Standard: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

input.resolutionstringoptional

Auflösungsstufe des Ausgabebildes. Verwende die kleingeschriebenen Werte 1k, 2k oder 4k. Wenn das Feld fehlt oder leer ist, wird standardmäßig 2k verwendet.

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": "nano-banana-2-1",
  "input": {
    "prompt": "Ein cineastisches Produktfoto einer futuristischen Kamera in Bananenform",
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-2-1",
    "status": "processing",
    "credits": 20
  }
}

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": "nano-banana-2-1",
    "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": "nano-banana-2-1",
    "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	20	30

Optionale Parameter weggelassen: 12 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.