API-Einführung Schnellstart Nano Banana Pro Nano Banana 2 Nano Banana 2 Lite

Erste Schritte

Schnellstart

Starten Sie mit der Nano Banana API über einen Bearer-Token, einen JSON-Request-Body und die beiden Produktionsendpunkte create und check.

Was Sie benötigen

AEin Nano Banana Konto mit verfügbaren Credits
Ein im API-Schlüssel-Dashboard erstellter API-Schlüssel

API-Schlüssel abrufen

Melden Sie sich an, öffnen Sie die Seite „API-Schlüssel“, geben Sie einen Schlüsselnamen ein und klicken Sie auf Erstellen. Kopieren Sie den Schlüssel sofort; der vollständige Schlüssel wird nur einmal angezeigt.

HTTP-Request-Header konfigurieren

Basis-URL

HTTPS

https://nanobanana.io

HTTP

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Schnellstart

Senden Sie eine JSON-Payload, um eine asynchrone Generierungsaufgabe zu erstellen. Speichern Sie die zurückgegebene task_id und verwenden Sie sie, um den Aufgabenstatus abzufragen.

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": "1k"
  }
}'

Antwort

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

Aufgabe erstellen

Senden Sie eine Modell-ID und ein Eingabeobjekt, um eine asynchrone Generierungsaufgabe zu erstellen. Dieser Endpunkt bestätigt, dass die Aufgabe in die Warteschlange aufgenommen wurde; er wartet nicht auf das endgültige Medienergebnis.

POST/api/v1/create

Autorisierungen

Feld

Typ

erforderlich

Beschreibung & Einschränkungen

Authorizationstringerforderlich

API-Schlüssel als Bearer-Token im Request-Header. Beispiel: Authorization: Bearer sk_live_your_api_key

Request-Body

application/json

Feld

Typ

erforderlich

Beschreibung & Einschränkungen

modelstringerforderlich

Öffentliche Modell-ID. Verwenden Sie ein im API-Bereich aufgeführtes Modell, zum Beispiel nano-banana-2.

inputobjecterforderlich

Generierungseingabe. Sie muss ein nicht leeres prompt enthalten. Weitere Eingabefelder sind modellspezifisch; lesen Sie die jeweilige Modelldokumentation, bevor Sie Felder wie Bilder, Seitenverhältnis, Dauer, Auflösung oder Anzahl senden.

JSON

{
  "model": "nano-banana-2",
  "input": {
    "prompt": "Ein cineastisches Produktfoto einer futuristischen Kamera in Bananenform",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}

Erstellungsantwort

application/json

Eine erfolgreiche Antwort enthält die Aufgaben-ID, Modell-ID, den Warteschlangenstatus und die Anzahl der für diese Aufgabe reservierten Credits.

HTTP 201

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

Aufgabenstatus abrufen

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

Request-Body

application/json

Feld

Typ

erforderlich

Beschreibung & Einschränkungen

task_idstringerforderlich

Die von POST /api/v1/create zurückgegebene Aufgaben-ID. Verwenden Sie diese ID, um den Aufgabenstatus und die URLs der Endergebnisse abzurufen.

JSON

{
  "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617"
}

Statusantwort

application/json

Nach Abschluss der Verarbeitung enthält die Antwort die URLs der Endergebnisse und Zeitmetadaten. Solange die Aufgabe noch läuft, data wird als null.

HTTP 200

{
  "id": "adc0e6ec-9c12-44fc-b45f-112187766c3",
  "created_at": 1788652800,
  "model": "nano-banana-2",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.nanobanana.io/api/predictions/example.mp4"
    ],
    "processing_time": 48
  }
}