API

Nano Banana 2 Lite API

Bild

Die Nano Banana 2 Lite API bietet schnelle, effiziente Bildgenerierung mit zuverlässiger Charakterkonsistenz, nahtloser Multi-Image-Kombination und Bearbeitung in natürlicher Sprache für alltägliche kreative Workflows. Integrieren Sie Nano Banana 2 Lite API für eine schlanke, hochwertige visuelle Generierung.

Autorisierungen

Bearerstringheadererforderlich

API-Schlüssel zur Autorisierung von Anfragen

Body

application/json

modelstringerforderlich

nano-banana-2-lite

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

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-lite",
  "input": {
    "prompt": "Ein cineastisches Produktfoto einer futuristischen Kamera in Bananenform"
  }
}'

POST /api/v1/create · HTTP 201

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

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-lite",
    "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-lite",
    "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.
Generierung	Credits pro Anfrage
Ein Bild	18

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.