Nano Banana 2.1

ID:google/nano-banana-2.1

Nano Banana 2.1 Bilderzeugung-API von Google — das Gemini-Flash-Bildmodell, aufgewertet für visuelles Design, Bearbeitung und Motivkonsistenz, bis 4K mit 14 Referenzbildern.

Nano Banana 2.1Gemini ImageGoogleBildbearbeitung4K

Übersicht

Nano Banana 2.1 Bilderzeugung-API von Google — das Gemini-Flash-Bildmodell, aufgewertet für visuelles Design, Bearbeitung und Motivkonsistenz, bis 4K mit 14 Referenzbildern.

Authentifizierung

Alle API-Anfragen erfordern einen gültigen API-Schlüssel im Authorization-Header mit dem Bearer-Schema.

Schnellstart

Zugangsdaten

Setze die Umgebungsvariable RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Ausführung erstellen

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2.1",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Ausführungen

Ausführungen werden asynchron verarbeitet. Sende eine Anfrage und frage dann das Ergebnis ab.

Ausführung erstellen

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2.1",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Ausführungsstatus abrufen

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Ergebnis abrufen

Frage den Status-Endpunkt ab, bis status den Wert "succeeded" hat, und lies dann output.urls aus der Antwort.

Input-Schema

Parameter	Typ	Erforderlich	Beschreibung
prompt	string	Erforderlich	Prompt
aspect_ratio	string	Optional	Aspect ratioOptionen: `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	Optional	ResolutionOptionen: `1K2K4K`
image_urls	string[]	Optional	Reference images

Output-Schema

Feld	Typ	Beschreibung
urls	string[]	Generierte Ausgabe-URLs

Fehler

Die API verwendet Standard-HTTP-Statuscodes zur Anzeige von Erfolg oder Fehlern.

Statuscode	Beschreibung
400	잘못된 요청 - 매개변수가 누락되었거나 형식이 올바르지 않습니다
401	인증 실패 - API 키가 누락되었거나 유효하지 않습니다
402	크레딧 부족
403	접근 거부 - IP가 허용되지 않았거나, 계정이 차단되었거나, API 키 지출 한도 초과
404	실행을 찾을 수 없습니다
429	요청 속도 제한 초과
500	내부 서버 오류