API

Nano Banana 2 API

Bild

Die Nano Banana 2 API kombiniert Echtzeit-Weltwissen mit fortschrittlichem Reasoning für besseres Prompt-Verständnis und präzisere visuelle Ergebnisse. Erzeugen Sie konsistente Multi-Subject-Bilder in nativem 4K, nutzen Sie flexible Seitenverhältnisse und erstellen Sie hochwertige globale Typografie auch in komplexen Kompositionen. Integrieren Sie Nano Banana 2 API, um intelligentere, skalierbare und hochwertige Bild-Workflows aufzubauen.

Autorisierungen

Bearerstringheadererforderlich

API-Schlüssel zur Autorisierung von Anfragen

Body

application/json

modelstringerforderlich

nano-banana-2

input.promptstringerforderlich

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

Maximale Länge: 5.000 Zeichen

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.

Maximale Anzahl: 14

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

Ausgabeauflösungsstufe; Groß- und Kleinschreibung wird nicht berücksichtigt. Lassen Sie das Feld weg oder leer, um den Standardwert zu verwenden.

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",
  "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",
    "status": "processing",
    "credits": 30
  }
}

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",
    "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",
    "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	20	30	40

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