错误 - 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 指出链耗尽时正在尝试哪个回退。详见响应头。