Reihe Nano Banana

Die Gemini-Bildmodelle von Google, insgesamt fünf. Empfohlen ist der Aufruf über den nativen Gemini-Endpunkt, mit dem sich Seitenverhältnis und Auflösung genau steuern lassen; der OpenAI-kompatible Endpunkt funktioniert ebenfalls, unterstützt aber nur einen Teil der Parameter.

Häufige Aufgaben

Seitenverhältnis und Auflösung festlegen Querformat, Hochformat, große 4K-Bilder und die von den einzelnen Modellen unterstützten Werte.Bearbeiten und Kombinieren Bilder hochladen und per Textanweisung bearbeiten.Fehlerbehebung 400 invalid argument, falsches Seitenverhältnis, kein Bild in der Antwort, 410.

Modellwahl

Kurz gesagtFür übliche Anwendungen ist Nano Banana 2 empfohlen; für 4K-Ausgabe oder komplexe Bildkompositionen Pro; für die Batch-Generierung kleiner Bilder 2 Lite.

Nano Banana 2.1Neuestes

Drei Stufen: 1K, 2K, 4K
Seitenverhältnisse von 1:8 bis 8:1; 2K und 4K gemessen etwa 2 Minuten

gemini-nano-banana-2.1

Nano Banana 2Erste Wahl für den Alltag

Vier Auflösungsstufen von 512 bis 4K
Die meisten Seitenverhältnisse, einschließlich 1:8 und 8:1

gemini-3.1-flash-image

Nano Banana ProQualität zuerst

Drei Stufen: 1K, 2K, 4K
Führt vor der Generierung Reasoning durch, daher länger

gemini-3-pro-image

Nano Banana 2 LiteGeschwindigkeit zuerst

Nur 1K
Gemessen etwa 5 Sekunden pro Bild, Ausgabe als JPEG

gemini-3.1-flash-lite-image

Nano BananaVorherige Generation

Fest etwa 1K, Auflösung nicht wählbar
Für bestehende Projekte weiter nutzbar

gemini-2.5-flash-image

Modell-IDs (beim Aufruf exakt kopieren)

Nano Banana 2.1google/gemini-nano-banana-2.1Neuestes

Nano Banana 2google/gemini-3.1-flash-imageErste Wahl für den Alltag

Nano Banana Progoogle/gemini-3-pro-image4K, komplexe Kompositionen

Nano Banana 2 Litegoogle/gemini-3.1-flash-lite-imageNur 1K

Nano Bananagoogle/gemini-2.5-flash-imageVorherige Generation

Aktuelle Preise finden Sie auf den Modellseiten: Nano Banana 2 , Nano Banana Pro . Tatsächlich abgerechnet wird nach usageMetadata in der Antwort.

Endpunktwahl

Kurz gesagtWenn Sie Seitenverhältnis und Auflösung steuern möchten, verwenden Sie den nativen Gemini-Endpunkt.

	Nativer Gemini-Endpunkt (empfohlen)	OpenAI-kompatibler Endpunkt
Adresse	`POST /gemini/v1beta/models/<Modell-ID>:generateContent`	`POST /v1/images/generations`, `/v1/images/edits`
Seitenverhältnis	`imageConfig.aspectRatio`	`aspect_ratio` auf oberster Ebene
Auflösung	`imageConfig.imageSize`: 512, 1K, 2K, 4K	Nicht unterstützt; `image_size` liefert 400
`size: "WIDTHxHEIGHT"`	Nicht anwendbar	Nicht unterstützt; Seitenverhältnis mit `aspect_ratio` angeben
`n` für mehrere Bilder	Nicht anwendbar	Nicht unterstützt; ein Bild pro Anfrage
Bearbeitung	`inlineData` in `parts`	Datei an `/v1/images/edits` hochladen
Referenzbilder `input_images`	Nicht anwendbar	Nicht unterstützt; zum Bearbeiten `/v1/images/edits` verwenden
Rückgabe	`candidates[0].content.parts[].inlineData.data`	`data[0].b64_json`

Latenz und Timeouts

Kurz gesagtSetzen Sie das Client-Timeout auf mindestens 300 Sekunden.

Die API ist synchron. Gemessen dauert 1K etwa 5 bis 20 Sekunden, 4K etwa 30 Sekunden; 2K und 4K mit Nano Banana 2.1 etwa 2 Minuten. In Spitzenzeiten dauert es länger. Pro führt vor der Bildgenerierung Reasoning durch (die Antwort enthält thoughtsTokenCount) und braucht daher länger als Nano Banana 2 bei gleicher Auflösung. Das übliche Standard-Timeout von 60 Sekunden reicht für 4K und für Anfragen in Spitzenzeiten nicht aus; trennt der Client die Verbindung, wird die Anfrage trotzdem abgerechnet.

Antwortstruktur

200 OK (nativer Endpunkt, data gekürzt)


{
  "candidates": [{
    "content": {
      "parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgo…" } }],
      "role": "model"
    },
    "finishReason": "STOP"
  }],
  "modelVersion": "google/gemini-3-pro-image",
  "usageMetadata": {
    "promptTokenCount": 7,
    "candidatesTokenCount": 2000,
    "candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 2000 }],
    "thoughtsTokenCount": 211,
    "totalTokenCount": 2218
  }
}

Das Bild steht in dem Eintrag von parts, der inlineData enthält; das ist nicht zwingend der erste Eintrag, davor kann Text stehen. Durchlaufen Sie parts, um es zu finden.
Der Wert des Eintrags IMAGE in candidatesTokensDetails ist die Token-Anzahl des Ausgabebildes. Gemessen: 1.120 bei 1K, 2.000 bei 4K mit Pro.
thoughtsTokenCount erscheint nur in Antworten von Pro und gibt die Reasoning-Tokens vor der Bildgenerierung an.

Offizielle Dokumentation

Die offizielle Dokumentation beschreibt das Verhalten bei direktem Aufruf von Google; beim Aufruf über OfoxAI gelten die gemessenen Ergebnisse dieser Seite.

Häufige Fragen

Wie generiere ich mit Nano Banana Pro 4K-Bilder?

Verwenden Sie den nativen Gemini-Endpunkt, senden Sie in generationConfig.imageConfig imageSize: "4K" und geben Sie das Seitenverhältnis mit aspectRatio an. Gemessen lieferte 4K bei 16:9 ein Bild mit 5504x3072, etwa 16 MB, in etwa 33 Sekunden. Der OpenAI-kompatible Endpunkt unterstützt imageSize nicht; image_size liefert 400.

Welche Seitenverhältnisse unterstützt Nano Banana 2?

Die 10 gängigen: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9; zusätzlich die vier extrem breiten bzw. hohen Verhältnisse 1:4, 4:1, 1:8, 8:1. Seitenverhältnisse außerhalb dieser Liste liefern 400 Request contains an invalid argument.

Unterstützt Nano Banana Pro 1:8 oder 4:1?

Nein. Die vier Seitenverhältnisse 1:4, 4:1, 1:8 und 8:1 werden nur von Nano Banana 2.1, Nano Banana 2 und Nano Banana 2 Lite unterstützt; für extrem hohe oder breite Bilder verwenden Sie eines dieser drei Modelle.

Schreibe ich bei imageSize 4K oder 4k?

Empfohlen sind Großbuchstaben 1K, 2K, 4K, wie in der offiziellen Dokumentation von Google. Gemessen akzeptiert OfoxAI auch Kleinbuchstaben. Die Stufe 512 hat kein K und wird nur von Nano Banana 2 unterstützt.

Wie lege ich das Seitenverhältnis von Nano Banana über den OpenAI-kompatiblen Endpunkt fest?

Mit aspect_ratio auf oberster Ebene, z. B. "16:9". Dieser Endpunkt unterstützt keinen Auflösungsparameter; für 2K oder 4K verwenden Sie imageConfig.imageSize am nativen Gemini-Endpunkt.

Kann Nano Banana mehrere Bilder auf einmal generieren?

Nein, jede Anfrage generiert ein Bild. Für mehrere Bilder senden Sie mehrere Anfragen parallel und beachten dabei die Ratenlimits.

Welches Timeout ist für Nano Banana sinnvoll?

Empfohlen sind mindestens 300 Sekunden. Gemessen dauert 1K etwa 5 bis 20 Sekunden, 4K etwa 30 Sekunden, 2K und 4K mit Nano Banana 2.1 etwa 2 Minuten; in Spitzenzeiten länger. Pro führt vor der Generierung Reasoning durch und braucht länger als Nano Banana 2.