Fehler 400: was tun, wenn gemini-2.5-pro fehlschlägt

Ein 400 bedeutet, dass die Anfrage selbst ungültig ist — ein fehlendes Feld, ein falscher Typ oder ein Parameter, den dieses Modell nicht unterstützt. Ein erneuter Versuch hilft nicht; der Request-Body muss geändert werden.

400 Bad Request bedeutet, dass der Server die Anfrage ablehnt, weil der Body selbst ungültig ist. Anders als bei 5xx löst sich ein 400 nicht durch Wiederholen — Sie erhalten jedes Mal dieselbe Antwort. Die Parameter müssen zuerst korrigiert werden.

gemini-2.5-pro wird von Google bereitgestellt. Alles auf dieser Seite — Ursachen, Lösungen und gemessene Daten — basiert auf dem tatsächlichen Laufzeitverhalten dieses Modells auf der Gatewayschicht.

An diesem Gateway ist die häufigste Ursache: Ein Pflichtfeld fehlt (model oder messages). Empfohlene erste Maßnahme: Vergleichen Sie den Request-Body mit der Parametertabelle auf dieser Seite.

Häufige Ursachen

  • Ein Pflichtfeld fehlt (model oder messages)
  • Ein Parameter hat den falschen Typ
  • Ein Parameter wird von diesem Modell nicht unterstützt
  • messages ist fehlerhaft oder role hat einen ungültigen Wert

So beheben Sie es

  • Vergleichen Sie den Request-Body mit der Parametertabelle auf dieser Seite
  • Entfernen Sie nicht unterstützte Parameter und versuchen Sie es erneut
  • Stellen Sie sicher, dass messages ein Array mit gültigen role-Werten ist
  • Starten Sie mit einer minimalen Anfrage und ergänzen Sie Parameter schrittweise

Wiederholung mit exponentiellem Backoff

Der folgende Code wiederholt den Aufruf, wenn gemini-2.5-pro 400 liefert: bis zu 5 Versuche, mit wachsender Wartezeit und zufälligem Jitter, damit parallele Anfragen nicht gleichzeitig wiederholen. Base-URL und API-Key werden aus Umgebungsvariablen gelesen — nicht hart codieren.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'gemini-2.5-pro'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Wichtige Daten zu diesem Modell

API-Endpunkthttps://api.airai.cc/v1
OpenAI-kompatibelOpenAI-compatible
AnbieterGoogle
Kontext1M
FunktionenReasoning, Tools, Files, Vision, Audio
API-Formateopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Abrechnungsformelp * 1.25 + cr * 0.125 + c * 10) : tier("200k_plus", p * 2.5 + cr * 0.25 + c * 15

Häufige Fragen

Lassen sich 400 durch asynchrone oder Batch-Verarbeitung vermeiden?

Parallelität und Timeouts sind hier die eigentlichen Variablen, nicht das Modell. Senken Sie zuerst die Parallelität — die meisten Durchsatzprobleme verschwinden dann. Dieses Modell hat ein Kontextfenster von 1M und stammt von Google. Bei langen Ausgaben erhöhen Sie den Timeout auf 60 Sekunden oder mehr. Starten Sie mit niedriger Parallelität, beobachten Sie einige Minuten, dann steigern.

Hängt 400 bei gemini-2.5-pro mit meinem Kontingent zusammen?

Es geht vor allem um das Kontingent, nicht um einen Defekt des Modells. Sowohl ein höheres Tariflimit als auch eine niedrigere Aufruffrequenz helfen. Bei der Abrechnung p * 1.25 + cr * 0.125 + c * 10) : tier("200k_plus", p * 2.5 + cr * 0.25 + c * 15 werden fehlgeschlagene Anfragen nicht angerechnet. Prüfen Sie zuerst Guthaben und Rate-Limits in der Konsole, dann den Code.

Hängt 400 mit der Fähigkeit des Modells selbst zusammen?

Meist ist es ein kurzzeitiges Problem, das von selbst verschwindet. Die Fähigkeits-Tags dieses Modells sind Reasoning, Tools, Files, Vision, Audio. Besteht der Fehler mehrere Minuten, kontaktieren Sie den Plattform-Support zum Upstream-Status.

Welche Angaben braucht der Support bei einer Fehlermeldung?

Gruppieren Sie die Fehler nach Zeit und Knoten; das Muster ist meist deutlich. Das Modell wird von Google bereitgestellt, der Upstream-Status richtet sich nach den Ankündigungen des Anbieters. Reproduzieren Sie es zuerst in der Testumgebung mit demselben Request-Body.

Weitere Fehler bei diesem Modell

Andere Modelle mit demselben Fehler

Zurück zur Modellseite

Daten aktualisiert: 2026-10-10 08:15

Technischer SupportLive-Support
Nach oben