❌ 错误码

当 API 请求出错时，响应体中会包含业务错误码和错误信息，帮助你快速定位问题。

错误响应格式

所有网关错误响应遵循统一信封格式：code 为业务错误码（与 HTTP 状态码一致），message 为人类可读的错误信息，data 恒为 null。

json

{
  "code": 401,
  "message": "缺少 API Key",
  "data": null
}

⚠️ 请求参数（400）

HTTP / code	message	说明与排查建议
400	`缺少 model 参数`	请求体未携带 `model` 字段。请检查请求 JSON。
400	`messages 必须是非空数组`	`POST /v1/messages` 的 `messages` 缺失、非数组或为空。
400	`缺少 anthropic-version 请求头`	调用 `POST /v1/messages` 时必须携带 `anthropic-version` 请求头（如 `2023-06-01`）。

🔐 认证与权限（401 / 403）

HTTP / code	message	说明与排查建议
401	`缺少 API Key`	请求未携带认证头。请添加 `Authorization: Bearer <key>` 或 `x-api-key: <key>`。
401	`API Key 无效`	Key 不存在或已删除。请前往控制台确认或重新生成。
403	`API Key 已被禁用`	该 Key 已被停用。请在控制台重新启用或更换 Key。
403	`账号已被禁用`	账号已被停用。请联系平台客服。
403	`IP 不在白名单中`	该 Key 配置了 IP 白名单，当前来源 IP 不在允许范围内。请在控制台调整白名单。

💳 额度（402）

HTTP / code	message	说明与排查建议
402	`当月额度不足，请先充值`	账户当月可用额度不足以完成本次调用。请前往控制台充值后重试。

🔍 资源（404）

HTTP / code	message	说明与排查建议
404	`模型 <model> 不存在或未启用`	请求的模型 ID 不存在或未上架。请通过 `GET /v1/models` 获取当前可用清单。

🚦 限流（429）

HTTP / code	message	说明与排查建议
429	`API 调用过于频繁，请稍后再试`	已触发网关限流。请降低调用频率、退避重试，或联系平台提升限额。

🔧 服务端（5xx）

HTTP / code	message	说明与排查建议
502	`上游渠道全部不可用`	所有上游模型渠道暂时不可用。请稍后重试；若持续出现请联系技术支持。
502	`上游响应格式异常`	上游返回了无法解析的响应。请稍后重试；若持续出现请联系技术支持。
500	`计费失败，请联系管理员`	调用成功后的计费环节出现异常。请截图并联系平台客服。

如果错误码无法解决你的问题，欢迎联系我们获取技术支持。

前往控制台