錯誤 - OrcaRouter

錯誤信封

絕大多數錯誤響應使用這一 OpenAI 兼容的 JSON 形態：

{
  "error": {
    "message": "Descriptive error message",
    "type": "orcarouter_api_error",
    "code": "model_not_found"
  }
}

type 是一個廣義類別，code 是具體標識。某些快路徑失敗（尤其是工作區級別的 429）只返回 HTTP 狀態碼和相關響應頭，沒有 JSON body。

狀態	含義	典型原因
`400`	請求錯	參數無效、缺必填字段、schema 違規
`401`	未授權	API 密鑰缺失或無效
`403`	禁止	額度不足，或密鑰無權調用該模型
`404`	未找到	模型或端點不存在
`429`	請求過多	命中限流——詳見速率限制。響應總是帶 `Retry-After` 頭。
`500`	內部錯誤	OrcaRouter 側 bug
`502`	上游錯誤	所有上游服務商都失敗了（包括任何回退鏈）
`503`	服務不可用	所請求模型暫時在上游不可用

這些是網關簽發的代碼（錯誤來自 OrcaRouter，而非上游）：

如果你需要按代碼分支處理，優先匹配 error.code（具體），再回退到 error.type（廣義）。

流式響應中的錯誤無法用 HTTP 狀態碼（狀態碼在流打開時就已發出）。具體形態因端點而異：

錯誤以帶內的 data: {...} 分片到達：

data: {"error":{"message":"...","type":"upstream_error","code":""}}

data: [DONE]

把每一塊 data: 都當 JSON 解析；若它含 error 字段，就視該流為失敗。

Anthropic 使用 SSE 命名事件。流中失敗到達形式為：

event: error
data: {"type":"error","error":{"type":"overloaded_error","message":"..."}}

流在錯誤事件之后以 event: message_stop 結束（或被切斷）。

當 extra_body.models 被設置且鏈中所有模型都失敗時，你會得到一個 502，里面帶有最后一次上游錯誤的細節。響應頭 X-Orca-Fallback-Level 和 X-Orca-Fallback-Model 指出鏈耗盡時正在嘗試哪個回退。詳見響應頭。