Dla agentów AI: instrukcja konfiguracji krok po kroku — /docs/agents.md, indeks dokumentacji — /llms.txt.

Błędy i limity

Limity żądań, limity czasu i kody błędów bramy. Przy każdej odpowiedzi wyjaśniamy, kiedy występuje i co zrobić: ponowić żądanie czy je poprawić.

Liczby — z pola limits odpowiedzi GET /v1/capabilities: tam zawsze są aktualne wartości.

Długość odpowiedzi według modeli#

Bez max_tokens brama podstawia wartość domyślną: bez streamingu — krótszą, aby odpowiedź zmieściła się w timeoutach, w streamingu — pułap modelu. max_completion_tokens — to samo pole.

Treść błędu to obiekt error z polami message, type, code, param; nie każdy błąd ma wszystkie pola. Kieruj się statusem i type, doprecyzowuj po code: tekst message może się zmieniać. Format Anthropic — w sekcji Format błędów Anthropic.

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

Dopóki strumień nie jest otwarty, odmowa przychodzi zwykłym kodem odpowiedzi — jak bez streamingu. Po otwarciu status to już 200, a błąd przychodzi tak:

• Chat Completions — chunk joingonka-error z polem error, potem przerwanie bez [DONE].
• Bez streamingu po wczesnej odpowiedzi — status 200 i treść z polem error.
• Anthropic Messages — zdarzenie event: error, potem strumień się zamyka.
• OpenAI Responses — zdarzenie response.failed, przyczyna w response.error.code.
• Legacy Completions — data: {"error": …}, potem [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 odpowiada kopertą Anthropic: {"type": "error", "error": {"type", "message"}}.
• Odmowy bramy zachowują type z tabeli powyżej (insufficient_funds, model_unavailable i inne); pola code w tej kopercie nie ma — przyczyna jest w treści.
• Błędy formy żądania — invalid_request_error: brak wiadomości lub max_tokens, wywołanie narzędzia bez nazwy, nieznany model.
• Nieznana ścieżka — not_found_error, zbyt duża treść — request_too_large.

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

• Po pauzie z Retry-After: 429
• Z rosnącą pauzą — 1, 2, 4 s i dalej: 500, 502, 503 service_unavailable, 504
• Z innym modelem: 503 model_unavailable
• Nie powtarzaj bez zmian — popraw żądanie, klucz lub saldo: 400, 401, 402, 403, 404, 413, 415, 501

Każde ponowienie po 504 to nowe obciążenie wyceną wejścia; dla długich odpowiedzi włączaj stream: true.

Błąd się powtarza — napisz do wsparcia i załącz x-request-id z nagłówków odpowiedzi.