API
错误码
错误按调用格式返回：Anthropic 格式的接口返回 Anthropic 风格的错误体，OpenAI 兼容格式返回 OpenAI 风格。失败的请求不收费。
| 状态码 | code | 说明 |
|---|---|---|
| 400 | invalid_json / model_required | 请求体不是合法 JSON，或没有 model 字段 |
| 400 | model_not_supported | 暂不支持该模型：模型 id 写错、未上架，或不是 Claude 模型（目前只提供 Claude 全系），不转发、不扣费 |
| 401 | invalid_api_key | Key 不存在、格式不对或已删除 |
| 401 | api_key_expired | Key 已过有效期 |
| 402 | insufficient_balance | 余额不足，充值后自动恢复 |
| 402 | key_quota_exceeded | 这个 Key 达到了消费上限，可在控制台调高 |
| 403 | api_key_disabled | Key 已停用 |
| 403 | account_suspended | 账号已被停用 |
| 413 | request_too_large | 请求体超过 32 MB |
| 502 | upstream_unavailable | 上游暂时不可用，已自动尝试备用线路；请稍后重试 |
| 503 | no_upstream_channel | 当前没有可服务这个模型的上游 |
| 504 | upstream_timeout | 非流式请求 115 秒内没有生成完（经 Cloudflare 单个响应最多等 125 秒），已停止、不收费、不会自动重试；长输出请改用 "stream": true |
// OpenAI 兼容格式 { "error": { "message": "Insufficient balance", "type": "insufficient_balance", "code": "insufficient_balance" } } // Anthropic 格式 { "type": "error", "error": { "type": "billing_error", "message": "Insufficient balance", "code": "insufficient_balance" } }
每个响应都带 x-tokenarmy-request-id 头，反馈问题时请附上它。
Cloudflare 错误页
如果收到的是 Cloudflare 的 HTML 页面（响应头 server: cloudflare、没有 x-tokenarmy-request-id），说明请求在边缘节点就结束了，没有扣费。最常见的是 524：响应超过 125 秒还没开始。长输出请用 "stream": true，稍后重试即可。流式输出如果中途 125 秒没有任何数据，连接也会被断开，已生成的部分照常计费，可在控制台的请求记录里核对。