错误

所有错误都使用相同的 JSON 响应体。失败的请求绝不会以 HTTP 200 返回。把错误放在 200 响应之内的两种情形，见响应中的错误。

{
  "error": {
    "message": "Model \"example/unknown\" was not found.",
    "type": "not_found_error",
    "code": "model_not_found",
    "param": "model",
    "request_id": "req_0123456789abcdef0123456789abcdef",
    "doc_url": "https://example.com/docs/errors/#model_not_found"
  }
}

• message：面向人的简短说明。
• type：错误类别。
• code：供程序使用的稳定标识符。请根据 code 而不是 message 判断分支。
• param：导致错误的请求参数，没有则为 null。
• request_id：请求的 ID。联系支持时请保留它。
• doc_url：指向本页中该代码条目的链接。
• details：可选的机器可读补充信息。具体字段取决于错误：
  • 对于取值为固定集合的字段，details.allowed 会列出可接受的值。
  • 对于超出范围的数字，details.minimum 和 details.maximum 会给出允许的范围。
  • 对于 402，details.limit_source 为 balance 或 key。其他字段给出相关金额；如果是密钥的支出上限，还会给出周期和 details.resets_at。详见余额与 API 密钥限额。
  • 对于无法使用的参考图像 URL，details.reason 会说明原因。
  • 对于以 data URI 发送且过大的参考图像，details.max_bytes 为大小上限。
  • 对于 payload_too_large，details.max_bytes 为大小上限。
  • 当等待任务结果的请求因任务失败而失败时，details.job_id 为该任务的 ID。
  • 当请求取决于任务的状态时，例如取消已结束的任务，或下载没有文件的视频，details.status 为该任务的状态。

有两种情形会在 200 响应之内报告错误：

• 流式对话响应在开始之后失败。错误会作为流中的一个事件到达。详见对话。
• 失败的任务。读取任务会返回 200，任务的 error 字段与错误响应包含相同的字段。详见任务。

POST /v1/messages 以 Anthropic 的格式返回所有错误：type 为 error，错误本身在 error 中，request_id 是顶层字段。错误代码和 HTTP 状态码与下表相同。详见对话。

每个代码都链接回自己的行，因此 doc_url 中的锚点（#<code>）会打开对应的条目。