Para sa mga AI agent: step-by-step na gabay sa setup — /docs/agents.md, index ng dokumentasyon — /llms.txt.

Mga error at limitasyon

Mga limitasyon sa request, timeout, at error code ng gateway. Para sa bawat response, sinasabi kung kailan ito nangyayari at ano ang gagawin: ulitin ang request o ayusin ito.

Ang mga numero — mula sa field na limits ng sagot na GET /v1/capabilities: doon ay laging may aktwal na mga halaga.

Haba ng sagot ayon sa modelo#

Kung walang max_tokens, naglalagay ang gateway ng default: walang stream — mas maikli, upang ang sagot ay umangkop sa mga timeout, sa stream — ang kisame ng modelo. Ang max_completion_tokens — parehong field.

Ang katawan ng error ay isang object na error na may mga field na message, type, code, param; hindi lahat ng error ay may lahat ng field. Batayan ang status at type, tingnan ang code para sa detalye: ang teksto ng message ay maaaring magbago. Ang format ng Anthropic ay nasa seksyong Format ng error ng Anthropic.

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

Hangga't hindi pa bukas ang stream, dumarating ang pagtanggi sa karaniwang response code — tulad ng walang stream. Pagkatapos ng pagbukas, ang status ay 200, at ganito dumarating ang error:

• Chat Completions — chunk na joingonka-error na may field na error, tapos putol na walang [DONE].
• Walang stream pagkatapos ng maagang sagot — status na 200 at katawan na may field na error.
• Anthropic Messages — event na event: error, tapos nagsasara ang stream.
• OpenAI Responses — event na response.failed, ang dahilan ay nasa response.error.code.
• Legacy Completions — data: {"error": …}, tapos [DONE].

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

• Ang POST /v1/messages ay sumasagot ng envelope ng Anthropic: {"type": "error", "error": {"type", "message"}}.
• Pinapanatili ng mga pagtanggi ng gateway ang type mula sa talahanayan sa itaas (insufficient_funds, model_unavailable at iba pa); walang field na code sa envelope na ito — nasa teksto ang dahilan.
• Mga error sa form ng kahilingan — invalid_request_error: walang mensahe o max_tokens, tool call na walang pangalan, hindi kilalang modelo.
• Hindi kilalang path — not_found_error, masyadong malaking katawan — request_too_large.

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

• Pagkatapos ng pause mula sa Retry-After: 429
• May tumataas na pause — 1, 2, 4 s at higit pa: 500, 502, 503 service_unavailable, 504
• Sa ibang modelo: 503 model_unavailable
• Huwag ulitin nang walang pagbabago — itama ang kahilingan, key o balanse: 400, 401, 402, 403, 404, 413, 415, 501

Bawat muling pagsubok pagkatapos ng 504 ay bagong singil sa pagtatantya ng input; para sa mahahabang sagot, i-on ang stream: true.

Kung paulit-ulit ang error — sumulat sa support at isama ang x-request-id mula sa headers ng response.