Fehler timeout: was tun, wenn gpt-4o-mini fehlschlägt
Ein Timeout bedeutet, dass der Client aufgegeben hat, bevor die Antwort ankam. Streaming-Anfragen an LLMs trifft das am häufigsten, weil das Modell vor dem ersten Token nachdenkt und diese Denkphase keine Bytes liefert.
Ein Timeout ist kein HTTP-Statuscode, sondern eine clientseitige Wartegrenze. Die Anfrage erreichte meist das Gateway und wurde weitergeleitet, doch das Modell lieferte innerhalb der von Ihnen gesetzten Zeit kein Ergebnis. Langer Kontext, lange Ausgabe und nicht-streamende Aufrufe sind die drei häufigsten Auslöser.
gpt-4o-mini wird von OpenAI 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: Das Client-Timeout ist zu niedrig gesetzt. Empfohlene erste Maßnahme: Erhöhen Sie das Client-Timeout auf 300 Sekunden oder mehr.
Häufige Ursachen
- Das Client-Timeout ist zu niedrig gesetzt
- Ein langer Prompt oder Kontext erhöht die Latenz des ersten Tokens
- Das Modell bearbeitet eine lange Reasoning-Aufgabe
- Netzwerkschwankungen
So beheben Sie es
- Erhöhen Sie das Client-Timeout auf 300 Sekunden oder mehr
- Aktivieren Sie Streaming, damit Sie nicht auf die ganze Antwort warten
- Kürzen Sie den Kontext oder nutzen Sie ein schnelleres Modell
- Senken Sie max_tokens
Wiederholung mit exponentiellem Backoff
Der folgende Code wiederholt den Aufruf, wenn gpt-4o-mini timeout 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 = 'gpt-4o-mini'
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
| TPS | 260.87 |
|---|---|
| Durchschn. Latenz | 1408 ms |
| Erfolgsrate | 100% |
| API-Endpunkt | https://api.airai.cc/v1 |
| OpenAI-kompatibel | OpenAI-compatible |
| Anbieter | OpenAI |
|---|---|
| Kontext | 128K |
| Funktionen | Tools, Files, Vision |
| API-Formate | openai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search |
| Abrechnungsformel | p * 0.15 + cr * 0.075 + c * 0.6 |
Häufige Fragen
Wie kann ich timeout bei gpt-4o-mini vorbeugend vermeiden?
Halten Sie zusätzlich ein Ausweichmodell bereit. Dieses Modell von OpenAI hat mehrere Upstream-Knoten, zwischen denen das Gateway wechseln kann. Halten Sie ein leichteres Ersatzmodell bereit, damit der Hauptfluss nicht abbricht. Legen Sie den Modellnamen in die Konfiguration, dann braucht ein Upstream-Wechsel keine Codeänderung.
Wie viele Retry-Versuche sind sinnvoll?
Business-Code muss meist nicht geändert werden, nur der Aufruftakt. Die gemessene Erfolgsrate liegt bei 100%, der erste Retry bringt meist den größten Nutzen. Bei der Abrechnung p * 0.15 + cr * 0.075 + c * 0.6 werden fehlgeschlagene Anfragen nicht angerechnet. Setzen Sie die Obergrenze auf 3–5 Versuche und ergänzen Sie Jitter.
Zählen fehlgeschlagene Anfragen zum Rate-Limit-Kontingent?
Keine Berechnung: Nur tatsächlich erzeugter Output zählt zum Verbrauch. Die Abrechnung folgt p * 0.15 + cr * 0.075 + c * 0.6, ohne Ausgabe also keine Kosten. Bei der Abrechnung p * 0.15 + cr * 0.075 + c * 0.6 werden fehlgeschlagene Anfragen nicht angerechnet. Wenn Sie Kosten nach p * 0.15 + cr * 0.075 + c * 0.6 schätzen, rechnen Sie das Retry-Budget mit ein.
Warum liefert gpt-4o-mini nur zu bestimmten Zeiten timeout?
Tritt es nur in Produktion auf, ist es meist eine Umgebungsdifferenz, kein Modellfehler. Die gemessene Erfolgsrate beträgt 100%, die meisten Fehler zeigen sich als timeout. Das Modell wird von OpenAI bereitgestellt, der Upstream-Status richtet sich nach den Ankündigungen des Anbieters. Protokollieren Sie bei jedem Fehler die Request-ID — sie hilft mehr als der Statuscode. Reproduzieren Sie es zuerst in der Testumgebung mit demselben Request-Body.
Weitere Fehler bei diesem Modell
- gpt-4o-mini: Fehler 429 — Ursachen und Lösungen
- gpt-4o-mini: Fehler 500 — Ursachen und Lösungen
- gpt-4o-mini: Fehler 502 — Ursachen und Lösungen
- gpt-4o-mini: Fehler 503 — Ursachen und Lösungen
- gpt-4o-mini: Fehler 504 — Ursachen und Lösungen
- gpt-4o-mini: Fehler 401 — Ursachen und Lösungen
- gpt-4o-mini: Fehler 403 — Ursachen und Lösungen
- gpt-4o-mini: Fehler 400 — Ursachen und Lösungen
Andere Modelle mit demselben Fehler
- gpt-5
- claude-opus-5
- gemini-2.5-pro
- deepseek-v4-pro
- grok-4.3
- llama-3.3-70b-instruct
- qvq-max
- qwq-32b
- glm-5
- MiniMax-M3
- kimi-k3
- hy3
- doubao-seed-evolving
- mimo-v2.5
- gpt-4o
- claude-opus-4-6
Daten aktualisiert: 2026-10-10 12:10