错误码与错误响应

错误来自两处：路由之前的 Key 校验，以及端点处理逻辑（或其背后的模型供应商）。两者的响应体格式不同，所以先看 HTTP 状态码，再看错误码或类型。

#错误格式

#Key 校验

Key、账户、余额、额度或套餐问题会在路由前被拦截，所有端点都返回扁平结构：

{ "code": "INVALID_API_KEY", "message": "Invalid API key" }

#Anthropic 格式

/v1/messages、/v1/messages/count_tokens、仅 Chat Completions 分组的 404 以及缺少分组的 403 使用 Anthropic 结构：

{ "type": "error", "error": { "type": "rate_limit_error", "message": "Too many pending requests, please retry later" } }

#OpenAI 格式

OpenAI 分组上的 /v1/chat/completions 和 /v1/responses 使用 OpenAI 结构：

{ "error": { "type": "api_error", "message": "No available accounts: no available accounts supporting model: glm-5.4" } }

Anthropic 分组上的 /v1/responses 返回 {"error": {"code": "...", "message": "..."}}。

#视频格式

/v1/videos 系列端点返回 {"error": {"type": "<code>", "message": "..."}}，其中 type 是下文的视频错误码之一。

稳妥的客户端依次读取 code、error.type、error.code，都没有时再按 HTTP 状态码处理。

#Key 与账户错误

以下错误使用扁平格式。

#请求与路由错误

以下错误使用对应端点的 Anthropic 或 OpenAI 格式，表中为 error.type 的值。

文本模型没有 404“model not found”：未知或分组未提供的模型返回上面的 503 No available accounts。可以用 GET /v1/models 核对。

#图片、视频与音频错误

见 多模态任务 API 参考。

#流式过程中的错误

流开始后 HTTP 状态已经是 200，因此错误以 SSE 事件的形式发送，随后关闭流：

event: error
data: {"error":{"type":"upstream_error","message":"Upstream request failed"}}

以上是 OpenAI 协议的形式。在 /v1/messages 上，错误是一行 Anthropic 结构的 data:：data: {"type":"error","error":{"type":"...","message":"..."}}。收到 error 事件应视为请求失败：不要把已收到的部分输出当成完整结果，类型可重试时再重试。见 流式输出。

#X-Request-ID

每个响应都带有 X-Request-ID 响应头。如果你自己发送了 X-Request-ID，会原样返回，方便关联日志。部分模型的响应中，它会是模型供应商的请求 ID。由于 CORS 未暴露该响应头，浏览器读不到它；请从服务端调用 API。

curl -sD - -o /dev/null https://bigmodel.io/v1/models \
  -H "Authorization: Bearer $BIGMODEL_API_KEY" | grep -i x-request-id

#联系支持

打开 支持（或发邮件到 support@bigmodel.io），并附上：

• X-Request-ID 和请求时间（含时区）
• 端点和模型 ID
• HTTP 状态码和完整错误响应体
• 是否为流式请求
• 使用的 SDK 或工具及版本

请先移除 API Key、Authorization 请求头和敏感的提示内容。失败请求的请求体会在去除凭据后保留最多 30 天，因此近期的请求 ID 可以追查；见 数据与隐私。

#常见问题排查

所有请求都返回 503 No available accounts。 模型 ID 拼错（注意大小写和点号：deepseek-v4-pro，不是 DeepSeek-V4-Pro），或模型属于其他分组。

刚创建 Key 就返回 401。 环境变量或工具设置里还是旧 Key。打印前几位和控制台对比。

Agent 中出现 409 malformed_session_state。 客户端修改或重排了历史中的思考块或工具块。新开会话，或关闭会改写这些块的历史压缩功能。

#相关文档

• 限额与速率
• 认证与 API Key
• 计费与充值
• 状态页