Für KI-Agenten: Schritt-für-Schritt-Anleitung zur Einrichtung — /docs/agents.md, Dokumentationsindex — /llms.txt.

Fehler und Limits

Anfragelimits, Timeouts und Fehlercodes des Gateways. Zu jeder Antwort steht, wann sie auftritt und was zu tun ist: Anfrage wiederholen oder korrigieren.

Die Zahlen stammen aus dem Feld limits der Antwort von GET /v1/capabilities: dort stehen immer die aktuellen Werte.

Antwortlänge je Modell#

Ohne max_tokens setzt das Gateway den Standardwert ein: ohne Streaming — kürzer, damit die Antwort in die Timeouts passt, im Stream — die Obergrenze des Modells. max_completion_tokens — dasselbe Feld.

Der Fehlertext ist ein Objekt error mit den Feldern message, type, code, param; einige Felder sind nicht bei allen Fehlern vorhanden. Orientieren Sie sich am Status und type, prüfen Sie code: der Text message kann sich ändern. Das Anthropic-Format finden Sie im Abschnitt Format der Anthropic-Fehler.

{
  "error": {
    "message": "Model is currently overloaded in the Gonka network",
    "type": "rate_limit_exceeded",
    "code": "upstream_rate_limited"
  }
}

Solange der Stream nicht geöffnet ist, kommt die Ablehnung mit dem üblichen Antwortcode — wie ohne Streaming. Nach dem Öffnen ist der Status bereits 200, und der Fehler kommt so:

• Chat Completions — Chunk joingonka-error mit Feld error, dann Abbruch ohne [DONE].
• Ohne Streaming nach einer frühen Antwort — Status 200 und Body mit Feld error.
• Anthropic Messages — Event event: error, dann wird der Stream geschlossen.
• OpenAI Responses — Event response.failed, Ursache in response.error.code.
• Legacy Completions — data: {"error": …}, dann [DONE].

data: {"id":"joingonka-error","object":"chat.completion.chunk","model":"MiniMaxAI/MiniMax-M2.7","choices":[],"error":{"message":"Gonka network error","type":"api_error"}}

• POST /v1/messages antwortet mit einem Anthropic-Envelope: {"type": "error", "error": {"type", "message"}}.
• Gateway-Ablehnungen behalten type aus der Tabelle oben (insufficient_funds, model_unavailable und andere); das Feld code gibt es in diesem Envelope nicht — die Ursache steht im Text.
• Fehler im Anfrageformat — invalid_request_error: keine Nachrichten oder max_tokens, Tool-Aufruf ohne Namen, unbekanntes Modell.
• Unbekannter Pfad — not_found_error, zu großer Body — request_too_large.

event: error
data: {"type":"error","error":{"type":"timeout","message":"Upstream timeout"}}

• Nach einer Pause aus Retry-After: 429
• Mit wachsender Pause — 1, 2, 4 s und weiter: 500, 502, 503 service_unavailable, 504
• Mit einem anderen Modell: 503 model_unavailable
• Nicht unverändert wiederholen — korrigieren Sie Anfrage, Schlüssel oder Guthaben: 400, 401, 402, 403, 404, 413, 415, 501

Jede Wiederholung nach 504 ist eine neue Abbuchung der Eingabe-Schätzung; für lange Antworten aktivieren Sie stream: true.

Der Fehler tritt erneut auf — schreiben Sie an den Support und fügen Sie x-request-id aus den Antwort-Headern bei.