|

Behebung des Fehlers thought_signature 400 bei Nano Banana 2: Multimodale Bildbearbeitung erfordert die Rückübertragung der Denksignatur

VonAPIYI - Stable and affordable AI API

Anmerkung des Autors: Sie erhalten beim Nano Banana 2 die Fehlermeldung „Image part is missing a thought_signature“? Dies ist ein 400-Fehler, der auftritt, wenn die Denksignatur bei mehrstufigen Dialogen nicht zurückgegeben wird. Dieser Artikel erläutert die Ursachen, Lösungen und bietet Codebeispiele.

Wenn Sie beim Bearbeiten von Bildern mit Nano Banana 2 (gemini-3.1-flash-image-preview) diese Fehlermeldung erhalten:

{
  "status_code": 400,
  "error": {
    "message": "Image part is missing a thought_signature in content position 2, part position 1."
  }
}

Keine Panik – dies ist eine Anforderung des Mehr-Runden-Dialogmechanismus der Gemini 3-Modellreihe und kein Sicherheitsproblem oder Plattformfehler. Einfach ausgedrückt: Sie haben in der zweiten Anfrage ein zuvor generiertes Bild gesendet, jedoch ohne die zugehörige thought_signature (Denksignatur) beizufügen.

Kernnutzen: Nach dem Lesen dieses Artikels verstehen Sie die Funktionsweise der thought_signature, beherrschen 3 Lösungsansätze und wissen, wie Sie die Denksignatur bei der Bildbearbeitung in mehreren Runden korrekt handhaben.

nano-banana-2-thought-signature-error-400-fix-guide-de 图示

Kernanalyse des Nano Banana 2 thought_signature-Fehlers

Was bedeutet diese Fehlermeldung eigentlich?

Lassen Sie uns diese Fehlermeldung Schritt für Schritt aufschlüsseln:

Feld Bedeutung Erklärung
status_code: 400 Fehler bei den Anfrageparametern Kein serverseitiger Fehler, sondern ein Problem mit den übermittelten Parametern
Image part Bilddaten in der Anfrage Sie haben in der zweiten Anfrage ein Bild gesendet
missing a thought_signature Fehlende Denksignatur Dieses Bild wurde in der vorherigen Runde generiert und benötigt eine Signatur
content position 2, part position 1 2. Nachricht im Dialogverlauf, 1. Teil Genaue Lokalisierung der fehlenden Signatur

Kurz zusammengefasst: Die Gemini-API ist zustandslos. Das Modell verwendet die thought_signature (Denksignatur), um den logischen Kontext über mehrere Dialogrunden hinweg aufrechtzuerhalten. Wenn Sie eine zweite Runde für eine Bildbearbeitung starten, müssen Sie die vom Modell in der vorherigen Runde zurückgegebene thought_signature unverändert mitsenden, andernfalls erhalten Sie einen 400-Fehler.

Warum die Gemini 3-Serie die thought_signature erzwingt

Vergleich Gemini 2.x-Serie Gemini 3-Serie (inkl. NB2)
Denksignatur In einigen Szenarien optional Für alle Part-Typen zwingend erforderlich
Validierungsstrenge Locker Streng (Fehlen führt zu 400)
Anwendungsbereich Hauptsächlich für Funktionsaufrufe Text, Bilder, Funktionsaufrufe – alles betroffen
Automatische Verarbeitung Offizielles SDK erledigt das Offizielles SDK erledigt das

Die Modelle der Gemini 3-Serie (einschließlich des auf gemini-3.1-flash basierenden Nano Banana 2) erzwingen die Denksignatur aus folgenden Gründen:

  1. Wiederherstellung des logischen Zustands: Die Denksignatur ist eine verschlüsselte Darstellung des internen Denkprozesses des Modells, die es ermöglicht, den vorherigen „Denkzustand“ in der nächsten Runde wiederherzustellen.
  2. Kontinuität der Bildbearbeitung: Bei mehrstufigen Bildbearbeitungen muss das Modell verstehen, dass „dieses Bild von mir im vorherigen Schritt generiert wurde“, um die Bearbeitungsanweisungen korrekt auszuführen.
  3. Sicherheit und Konsistenz: Der Signaturmechanismus stellt sicher, dass der Dialogverlauf nicht manipuliert wurde, was die Zuverlässigkeit bei Interaktionen über mehrere Runden erhöht.

🎯 Wichtige Erkenntnis: Dieser 400-Fehler hat absolut nichts mit den Inhalts-Sicherheitsrichtlinien (IMAGE_SAFETY) zu tun und ist auch kein Problem der APIYI-Plattform. Es handelt sich um einen Standard-Mechanismus der Gemini 3-Modelle, der auf Code-Ebene korrekt behandelt werden muss.

3 Lösungswege für den Nano Banana 2 thought_signature-Fehler

nano-banana-2-thought-signature-error-400-fix-guide-de 图示

Lösung 1: Verwendung der Chat-Funktion des offiziellen SDK (Empfohlen)

Wenn Sie das offizielle SDK von Google (Python / Node.js / Java) verwenden, ist die einfachste Methode die Nutzung der Chat-Funktion. Das SDK verwaltet die thought_signature automatisch:

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

# Verwendung der Chat-Funktion, das SDK verwaltet die thought_signature automatisch
chat = client.chats.create(model="gemini-3.1-flash-image-preview")

# 1. Runde: Bild generieren
response1 = chat.send_message("Zeichne eine orangefarbene Katze auf einer Fensterbank")

# 2. Runde: Bild bearbeiten (Signatur wird automatisch mitgesendet)
response2 = chat.send_message("Setz der Katze eine Weihnachtsmütze auf")

Lösung 2: Manuelles Extrahieren und Zurücksenden der thought_signature

Wenn Sie benutzerdefinierte HTTP-Aufrufe oder eine OpenAI-kompatible Schnittstelle verwenden, müssen Sie die Signatur manuell verarbeiten. Die entscheidende Logik lautet: Extrahieren Sie die thought_signature aus der vorherigen Antwort und fügen Sie sie in der entsprechenden Komponente der nächsten Anfrage unverändert bei.

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# 1. Runde: Bild generieren
response1 = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{"role": "user", "content": "Zeichne eine orangefarbene Katze"}]
)

# Wichtig: Speichern Sie die vollständige Modellantwort
# Einschließlich Bilddaten und thought_signature
model_reply = response1.choices[0].message

# 2. Runde: Bild bearbeiten
# Übergeben Sie die vollständige Modellantwort als Teil des Dialogverlaufs
response2 = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[
        {"role": "user", "content": "Zeichne eine orangefarbene Katze"},
        model_reply,  # Vollständig zurücksenden, inklusive thought_signature
        {"role": "user", "content": "Setz der Katze eine Mütze auf"}
    ]
)

Lösung 3: Wechsel zu Einzelrunden-Anfragen

Wenn Ihr Szenario keine mehrstufige Dialogbearbeitung erfordert, können Sie jedes Mal unabhängige Einzelanfragen senden, um das Problem mit der thought_signature vollständig zu umgehen:

# Einzelne Bildbearbeitung: Senden Sie direkt das Originalbild + Bearbeitungsanweisung
response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": "data:image/png;base64,/9j/..."}},
            {"type": "text", "text": "Setz dieser Katze eine Weihnachtsmütze auf"}
        ]
    }]
)

🎯 Empfehlung: Für neue Projekte wird Lösung 1 (Chat-Funktion des offiziellen SDK) empfohlen. Bei bestehenden Projekten können Sie je nach Aufwand Lösung 2 oder 3 wählen. Bei Aufrufen von Nano Banana 2 über APIYI (apiyi.com) funktionieren sowohl Lösung 2 als auch 3 einwandfrei.

Häufige Missverständnisse zu Nano Banana 2 thought_signature

Missverständnis Fakt
Dies ist ein Problem mit der Inhaltssicherheit Nein. Der 400-Fehler ist ein Fehler bei der Parameterprüfung und hat nichts mit IMAGE_SAFETY zu tun
Dies ist ein Problem der API-Plattform Nein. Dies ist eine mechanische Anforderung der Gemini 3-Modellreihe
Man kann die Signatur selbst erstellen Nein. Die Signatur ist verschlüsselt; der vom Modell zurückgegebene Wert muss unverändert zurückgesendet werden
Nur bei Funktionsaufrufen erforderlich Alle Part-Typen der Gemini 3-Reihe können dies erfordern
Einstellung thinking: off hilft Nein. Selbst wenn die Thinking-Ebene auf "minimal" gesetzt ist, wird die Signatur zurückgegeben und muss zurückgesendet werden

Position von thought_signature in der Nano Banana 2-Antwort

In den Antwortdaten von Nano Banana 2 müssen zwei spezielle Parts beachtet werden:

Temporäre Bilder (thought: true): Zwischenbilder, die während des Modell-Inferenzprozesses entstehen und als thought: true markiert sind. Dies sind temporäre Daten, die dem Benutzer nicht angezeigt werden müssen.

Endgültige Bilder (inkl. thought_signature): Das endgültig generierte Bild enthält ein thought_signature-Feld. Dies ist die Signatur, die Sie in der nächsten Anfrage zurücksenden müssen.

{
  "candidates": [{
    "content": {
      "parts": [
        {
          "inlineData": {"mimeType": "image/png", "data": "..."},
          "thought_signature": "CkYKRAo..."
        }
      ]
    }
  }]
}

🎯 Technische Details: thought_signature ist eine verschlüsselte Zeichenfolge mit einer Länge von normalerweise 200–500 Zeichen. Versuchen Sie nicht, sie zu analysieren, zu ändern oder selbst zu konstruieren – senden Sie genau das zurück, was Sie erhalten haben. Bei einem Aufruf über den API-Proxy-Dienst APIYI (apiyi.com) ist das Antwortformat identisch mit der nativen Google-API.

Checkliste zur Fehlerbehebung bei Nano Banana 2 thought_signature

nano-banana-2-thought-signature-error-400-fix-guide-de 图示

Schnelle 4-Schritte-Fehlerbehebung:

  1. Bestätigen, ob es sich um eine Multi-Turn-Anfrage handelt: Wenn Ihr messages-Array die vorherigen Antworten der Modell-Rolle enthält (insbesondere Bilddaten), handelt es sich um eine Multi-Turn-Anfrage.
  2. Prüfen, ob die vollständige Antwort gespeichert wurde: Enthält die Antwort des Modells aus der vorherigen Runde das Feld thought_signature? Wurde es vollständig gespeichert?
  3. Prüfen, ob die Signatur geändert wurde: Wurde die Signatur-Zeichenfolge während der JSON-Serialisierung/-Deserialisierung abgeschnitten oder maskiert?
  4. Prüfen der Part-Positionsausrichtung: Die Fehlermeldung content position X, part position Y hilft Ihnen dabei, genau zu lokalisieren, welchem Part die Signatur fehlt.

Häufig gestellte Fragen

Q1: Tritt dieser Fehler auch bei der einstufigen Bilderzeugung auf?

Normalerweise nicht. Der thought_signature-Fehler tritt fast ausschließlich in mehrstufigen Dialogen auf – also dann, wenn Sie Bilder, die vom Modell in einer vorherigen Runde zurückgegeben wurden, in den Dialogverlauf einfügen und eine neue Anfrage senden. Einstufige Text-zu-Bild- oder Bild-zu-Bild-Anfragen (bei denen das Originalbild direkt übergeben wird) beinhalten keinen Dialogverlauf und erfordern daher keine Signaturverarbeitung.

Q2: Wie gehe ich bei einem Aufruf über die OpenAI-kompatible Schnittstelle vor?

Wenn Sie Nano Banana 2 über die OpenAI-kompatible Schnittstelle von APIYI (apiyi.com) aufrufen, ist es entscheidend, das vollständige Objekt der Modellantwort aus der vorherigen Runde zu speichern und es bei der nächsten Anfrage als Teil des Dialogverlaufs zu übermitteln. Speichern Sie nicht nur die Bilddaten, während Sie andere Felder verwerfen. Falls Ihr Framework (z. B. Dify oder Cherry Studio) den Dialogverlauf automatisch verwaltet, stellen Sie sicher, dass die thought_signature vollständig beibehalten wird.

Q3: Müssen temporäre Bilder mit `thought: true` zurückgesendet werden?

Ja, das müssen sie. Nano Banana 2 kann während des Inferenzprozesses temporäre Bilder zurückgeben, die als thought: true markiert sind; diese sind Teil des „Denkprozesses“ des Modells. Beim Aufbau des Dialogverlaufs sollten alle vom Modell zurückgegebenen Teile (einschließlich der temporären Bilder) vollständig zurückgesendet werden. Der sicherste Weg ist, das vollständige Modellantwort-Objekt direkt zurückzugeben.

Zusammenfassung

Die Kernpunkte zum thought_signature 400-Fehler bei Nano Banana 2:

  1. Kein Problem der Inhaltssicherheit: Dies ist eine Anforderung des mehrstufigen Dialogmechanismus der Gemini 3-Modellreihe und steht in keinem Zusammenhang mit IMAGE_SAFETY.
  2. Ursache: Bei mehrstufigen Anfragen wurde die vom Modell in der vorherigen Runde zurückgegebene thought_signature nicht unverändert zurückgesendet.
  3. Lösung: Verwenden Sie die Chat-Funktion des offiziellen SDKs (diese übernimmt die Verarbeitung automatisch), extrahieren und senden Sie die Signatur manuell zurück oder nutzen Sie stattdessen einstufige Anfragen.

Denken Sie an das Grundprinzip: Die vom Modell zurückgegebene thought_signature darf weder verändert noch verworfen oder selbst konstruiert werden – senden Sie sie einfach so zurück, wie Sie sie erhalten haben.

Für Aufrufe von Nano Banana 2 über Drittanbieter-Plattformen empfehlen wir APIYI (apiyi.com). Das Antwortformat ist vollständig identisch mit der nativen Google-API, kostet $0,05 pro Aufruf und bietet unbegrenzte Nebenläufigkeit.

📚 Referenzmaterialien

  1. Offizielle Google-Dokumentation zu Thought Signatures: Detaillierte Erläuterung des Thought-Signature-Mechanismus

    • Link: ai.google.dev/gemini-api/docs/thought-signatures
    • Beschreibung: Offizielle Dokumentation, die Funktionsweise, Modellverhalten und SDK-Handhabung abdeckt.

  2. Google Gemini 3 Entwicklerhandbuch: Neue Funktionen der Gemini 3-Serie

    • Link: ai.google.dev/gemini-api/docs/gemini-3
    • Beschreibung: Erläuterung der obligatorischen Signaturanforderungen und neuen Funktionen der Gemini 3-Serie.

  3. Google-Dokumentation zur Bilderzeugung: Best Practices für die Nano Banana-Bilderzeugung

    • Link: ai.google.dev/gemini-api/docs/image-generation
    • Beschreibung: Empfehlungen zur Verwendung von thought_signature bei der mehrstufigen Bildbearbeitung.

  4. Google Cloud Vertex AI-Dokumentation: Erläuterungen zu Thought Signatures auf Unternehmensebene

    • Link: docs.google.com/vertex-ai/generative-ai/docs/thought-signatures
    • Beschreibung: Methoden zur Signaturverarbeitung und -konfiguration in der Vertex AI-Umgebung.

Autor: APIYI Technik-Team
Technischer Austausch: Diskutieren Sie gerne in den Kommentaren über Ihre Erfahrungen bei der Implementierung der mehrstufigen Bearbeitung mit Nano Banana 2. Weitere Informationen finden Sie im APIYI-Dokumentationszentrum unter docs.apiyi.com.

Try AI Large Model https://api.apiyi.com for free
Stable and reliable AI LM API aggregation service, Get 300 Millions Tokens for Free~

Ähnliche Beiträge