AI エージェント向け：セットアップの手順ガイド — /docs/agents.md、ドキュメントのインデックス — /llms.txt。

エラーと制限

ゲートウェイのレート制限、タイムアウト、エラーコード。各レスポンスについて、それが発生する条件と対処法（リクエストの再試行または修正）を説明します。

数値はレスポンスGET /v1/capabilitiesのlimitsフィールドにあります。常に最新の値が記載されています。

モデル別の出力の長さ#

max_tokensを指定しない場合、ゲートウェイはデフォルト値を適用します。非ストリーミングではタイムアウトに収まるよう短めに、ストリーミングではモデルの上限に。max_completion_tokensは同じフィールドです。

エラー本体は message, type, code, param フィールドを持つ error オブジェクトです。すべてのエラーに全フィールドがあるわけではありません。ステータスと type を基準にし、code で詳細を確認してください。message のテキストは変更される可能性があります。Anthropic 形式については Anthropic エラー形式 のセクションをご覧ください。

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

ストリームが開かれる前は、拒否は通常のレスポンスコードで返されます — 非ストリーミング時と同じです。開いた後はステータスが既に 200 となり、エラーは次のように返されます:

• Chat Completions — error フィールドを持つ joingonka-error チャンク、その後 [DONE] なしで切断されます。
• 早期応答後の非ストリーミング — ステータス 200 と error フィールドを持つボディ。
• Anthropic Messages — event: error イベント、その後ストリームが閉じられます。
• OpenAI Responses — response.failed イベント、原因は response.error.code にあります。
• Legacy Completions — data: {"error": …}、その後 [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 は Anthropic エンベロープで応答します: {"type": "error", "error": {"type", "message"}}。
• ゲートウェイの拒否は上記の表の type を保持します (insufficient_funds、model_unavailable など)。このエンベロープには code フィールドはなく、原因はテキストに記載されています。
• リクエスト形式のエラー — invalid_request_error: メッセージまたは max_tokens がない、名前のないツール呼び出し、未知のモデル。
• 不明なパス — not_found_error、ボディが大きすぎる — request_too_large。

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

• Retry-After に示された待機後: 429
• 指数的バックオフ — 1、2、4 秒以降: 500, 502, 503 service_unavailable, 504
• 別のモデルで: 503 model_unavailable
• 変更なしで再試行しない — リクエスト、キー、または残高を修正してください: 400, 401, 402, 403, 404, 413, 415, 501

504 後の各再試行は入力見積もりの新たな課金となります。長い応答には stream: true を有効にしてください。

エラーが繰り返す場合は、レスポンスヘッダーの x-request-id を添えてサポートにお問い合わせください。