Nano Banana: Fehlerbehebung
Die Parameterwerte finden Sie unter Nano Banana: Text zu Bild und Größen.
Nach Symptom suchen
400 Request contains an invalid argument
{
"error": {
"code": 400,
"message": "Request contains an invalid argument.",
"status": "INVALID_ARGUMENT"
}
}Dieser Fehler nennt den betroffenen Parameter nicht. Gemessen liefern alle folgenden Fälle diesen Fehler:
Vorgehen: Entfernen Sie zuerst imageConfig und wiederholen Sie die Anfrage. Wird das Bild dann normal generiert, liegt das Problem bei Seitenverhältnis oder Auflösung; fügen Sie die Werte danach einzeln wieder hinzu, um die Ursache einzugrenzen.
Seitenverhältnis oder Auflösung weicht ab
Prüfen Sie zuerst Breite und Höhe des ausgegebenen Bildes und gleichen Sie dann mit der folgenden Tabelle ab:
Korrekte Schreibweise:
{
"contents": [{ "parts": [{ "text": "..." }] }],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": { "aspectRatio": "9:16", "imageSize": "2K" }
}
}Beide Schreibweisen werden erkannt, imageConfig / image_config ebenso wie aspectRatio / aspect_ratio; gemessen lieferte image_config: { aspect_ratio: "9:16" } korrekt 768×1376.
Kein Bild in der Antwort
In Clients wie Cherry Studio oder LobeHub fügen Sie das Modell als Bildgenerierungsmodell hinzu, nicht als Chatmodell.
410 model_deprecated
{
"error": {
"message": "Model 'google/gemini-3-pro-image-preview' is deprecated and no longer accepts requests; please switch to an active model",
"type": "model_deprecated",
"code": 410
}
}Alte IDs mit der Endung -preview sind abgeschaltet; verwenden Sie die IDs der regulären Versionen:
Die Modell-ID im Pfad des nativen Endpunkts kann mit oder ohne Präfix google/ angegeben werden; gemessen funktionieren beide.
Bearbeitungsergebnis hat nichts mit dem Original zu tun
So prüfen Sie, ob das Referenzbild eingelesen wurde: Am nativen Endpunkt sehen Sie nach, ob usageMetadata.promptTokensDetails einen Eintrag IMAGE enthält; am OpenAI-kompatiblen Endpunkt prüfen Sie usage.input_tokens_details.image_tokens. Gemessen werden für ein Referenzbild mit 1024×1024 1.120 Tokens berechnet.
Sicherheitssperre
Wird eine Anfrage von der Sicherheitsrichtlinie blockiert, enthält die Antwort kein Bild; der Grund steht in finishReason oder promptFeedback.blockReason. Bedeutung der einzelnen Werte (nach der offiziellen Definition von Google):
Ihr Code sollte nicht davon ausgehen, dass die Antwort immer ein Bild enthält: Prüfen Sie zuerst, ob candidates vorhanden ist und ob finishReason gleich STOP ist, und lesen Sie erst dann inlineData. Die Definitionen der Felder finden Sie unter Gemini API · FinishReason .
Timeout, 504, 524
Die API ist synchron. Gemessen dauert 1K etwa 5 bis 20 Sekunden, 4K etwa 30 Sekunden; in Spitzenzeiten länger. Das übliche Standard-Timeout von 60 Sekunden reicht nicht aus.
- Setzen Sie das Client-Timeout auf mindestens 300 Sekunden.
- Prüfen Sie die Timeouts von Zwischen-Proxys wie Nginx, Vercel oder Cloudflare; deren Standardwerte betragen oft nur 60 bis 100 Sekunden.
- Ein 4K-PNG ist etwa 16 MB groß, der Response-Body größer als 20 MB; stellen Sie sicher, dass der Proxy große Antworten nicht abschneidet.
Trennt der Client die Verbindung vorzeitig, wird die Anfrage trotzdem abgerechnet.
Weitere Fehler
Geben Sie bei Anfragen an den technischen Support die request_id aus der Antwort und die vollständige Fehlermeldung an.
Häufige Fragen
Was tun beim Nano-Banana-Fehler Request contains an invalid argument?
Der Fehler nennt den betroffenen Parameter nicht; meist liegt das Seitenverhältnis oder die Auflösung außerhalb dessen, was das Modell unterstützt. Beispiele: 5:3 ist kein unterstütztes Seitenverhältnis; Nano Banana 2 Lite hat nur 1K; Pro hat kein 512; alle Modelle reichen höchstens bis 4K. Entfernen Sie zuerst imageConfig und wiederholen Sie die Anfrage, fügen Sie die Werte dann einzeln wieder hinzu, um die Ursache einzugrenzen.
Bei Nano Banana ist aspectRatio gesetzt, aber das Seitenverhältnis stimmt nicht. Was tun?
Prüfen Sie zuerst, ob imageConfig in generationConfig steht und nicht auf oberster Ebene des Request-Bodys. Prüfen Sie dann, ob das Modell den Wert unterstützt: Pro unterstützt 1:4, 4:1, 1:8 und 8:1 nicht; die vorherige Generation Nano Banana unterstützt imageSize nicht.
Warum finde ich in der Antwort von Nano Banana kein Bild?
Häufig liest der Code nur den ersten Eintrag von parts, während das Bild weiter hinten steht; durchlaufen Sie parts und suchen Sie nach inlineData. Eine weitere Ursache ist eine Sperre durch die Sicherheitsrichtlinie; in diesem Fall ist finishReason nicht STOP.
gemini-3-pro-image-preview liefert 410 model_deprecated. Was tun?
Die IDs der Vorschauversionen sind abgeschaltet. Ersetzen Sie google/gemini-3-pro-image-preview durch google/gemini-3-pro-image und google/gemini-3.1-flash-image-preview durch google/gemini-3.1-flash-image.
Was tun, wenn bei Nano Banana IMAGE_SAFETY erscheint?
IMAGE_SAFETY bedeutet, dass das generierte Bild von der Sicherheitsrichtlinie als Verstoß eingestuft wurde; eine unveränderte Wiederholung ändert das Ergebnis nicht. Ändern Sie den Prompt, vermeiden Sie reale Personen, urheberrechtlich geschützte Figuren oder sensible Inhalte, und versuchen Sie es erneut.
Das Referenzbild wirkt bei der Bearbeitung mit Nano Banana nicht?
input_images ist ein Feld von Qwen-Image und wird von Gemini nicht unterstützt. Laden Sie die Datei stattdessen an /v1/images/edits hoch, oder legen Sie das Bild am nativen Gemini-Endpunkt als inlineData zusammen mit dem Text in dieselben parts.