Skip to main content
POST
Hinweis zur Modellnamen-Kompatibilität: gemini-3.1-flash-lite-image ist mit dem Alias nano-banana-2-lite kompatibel, gemini-3.1-flash-lite-image-ext ist mit dem Alias nano-banana-2-lite-ext kompatibel. Jeder Name und sein Alias sind gleichwertig und austauschbar verwendbar.

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel erhalten:Besuchen Sie die Seite zur Verwaltung von API-Schlüsseln, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn dem Anfrage-Header hinzu:

Body

string
Standard:"gemini-3.1-flash-lite-image"
erforderlich
Name des BildgenerierungsmodellsFolgende Modellnamen werden unterstützt:
  • gemini-3.1-flash-lite-image (Nano Banana Lite, kompatibler Alias nano-banana-2-lite)
  • gemini-3.1-flash-lite-image-ext (kompatibler Alias nano-banana-2-lite-ext)
Beide haben identische Parameter und Einschränkungen (nur 1K, keine Unterstützung für google_search / official_fallback, maximal 14 Referenzbilder). Für keinen der beiden gibt es eine -official-Variante, und der Fallback-Parameter official_fallback wird ebenfalls nicht unterstützt. Die Abrechnung richtet sich nach der Backend-Konfiguration des jeweiligen Kanals.Die Aliase nano-banana-2-lite (entspricht gemini-3.1-flash-lite-image) und nano-banana-2-lite-ext (entspricht gemini-3.1-flash-lite-image-ext) sind ihren jeweiligen Originalnamen gleichwertig und austauschbar verwendbar.
string
erforderlich
Textbeschreibung für die Bildgenerierung
string
Seitenverhältnis des BildesUnterstützte Seitenverhältnisse:
  • auto – Seitenverhältnis automatisch wählen
  • 1:1 – Quadrat, Avatare, soziale Medien
  • 3:2 / 2:3 – Standardfotos
  • 4:3 / 3:4 – Klassisches Bildschirmverhältnis
  • 16:9 / 9:16 – Breitbild / Cover für vertikale Videos
  • 5:4 / 4:5 – Bilder für Instagram
  • 21:9 – Ultrabreites Banner
Bei Text-zu-Bild ist der Standardwert 1:1 oder 16:9, wenn size auf auto gesetzt ist; bei Bild-zu-Bild richtet sich das Seitenverhältnis nach der Antwort der vorgelagerten Quelle. (Wir empfehlen, ein Seitenverhältnis explizit anzugeben.)
string
Standard:"1K"
Auflösung des AusgabebildesUnterstützte Werte:
  • 1K – ~1024px, Standardauflösung (Lite unterstützt nur diese Stufe)
Lite unterstützt nur 1K. Bei Übergabe von 2K / 4K / 0.5K erfolgt eine stille Herabstufung auf 1K, ohne Fehler und ohne tatsächliche Ausgabe in hoher Auflösung. Die Frontend-UI muss keine Auflösungsoption anzeigen.
integer
Standard:"1"
Anzahl der zu generierenden BilderWertebereich: 1 ~ 4, Standard 1Bei n>1 sendet das Backend mehrere gleichzeitige Anfragen an die vorgelagerte Quelle und rechnet nach der tatsächlichen Anzahl erfolgreich generierter Bilder ab. Wir empfehlen, im Frontend fest 1 zu übergeben (Fortschritt bildweise anzeigen, transparentere Abrechnung).⚠️ Hinweis: Es muss eine reine Zahl übergeben werden (z. B. 1), keine Anführungszeichen verwenden, sonst tritt ein Fehler auf
array
Liste der URLs von Referenzbildern für die Bild-zu-Bild-GenerierungEs werden zwei Formate unterstützt:1. Vollständige Bild-URL
  • Öffentlich zugängliche Bild-URL (http:// oder https://)
  • Beispiel: https://example.com/image.jpg
2. Base64-kodiertes Format
  • Es muss das vollständige Data-URI-Format verwendet werden
  • Format: data:image/{format};base64,{base64data}
  • Unterstützte Bildformate: jpeg, png, webp
  • Beispiel: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Hinweis: Das Präfix data:image/jpeg;base64, muss enthalten sein
Einschränkungen:
  • Maximal 14 Referenzbilder (empfohlen: bis zu 10 Objektreferenzen + 4 Charakterreferenzen)
  • Größe eines einzelnen Bildes: maximal 10 MB
  • Unterstützte Formate: jpeg, png, webp
string
Callback-Adresse der Aufgabe (base)Bei Erfolg / Fehlschlag der Aufgabe ruft diese Plattform webhook + /callback auf (kein Weiterleiten an die vorgelagerte Quelle). Die Übergabe dieses Parameters kann das Polling deutlich reduzieren; wir empfehlen dennoch, das Polling als Absicherung beizubehalten.
Wichtige Hinweise zur Nutzung von Lite
  • google_search / google_image_search werden nicht unterstützt: Lite verwendet den interactions-Endpunkt der Developer API, die vorgelagerte Quelle stellt das Search-Tool nicht bereit (gibt “Search as tool is not enabled for this model” zurück), und der Plattform-Adapter sendet diesen Parameter nicht weiter. Bei Übergabe tritt kein Fehler auf, das Bild wird wie gewohnt generiert, jedoch ohne jegliche Sucherweiterung. Wenn Sie eine Sucherweiterung benötigen, verwenden Sie stattdessen gemini-3.1-flash-image-preview.
  • mask_url für lokales Inpainting wird nicht unterstützt (die Gemini-Reihe arbeitet mit aspect ratio + Referenzbildern, nicht mit Masken).
  • Abrechnung nach Token (im Unterschied zum festen Preis pro Bild bei flash/pro): Input ca. 0.25/MillionToken,Bildausgabeca.0.25/Million Token, Bildausgabe ca. 30/Million Token, ein 1K-Bild ≈ 1120 output token ≈ $0.0336/Bild. Der tatsächliche Preis richtet sich nach der Multiplikator-Konfiguration im Backend.
  • Alle generierten Bilder enthalten Googles unsichtbares SynthID-Wasserzeichen (Verhalten der vorgelagerten Quelle, kann nicht deaktiviert werden).

Response

integer
Statuscode der Antwort
array
Array mit Antwortdaten