错误码
最后更新：2026-04-24
TTToken 的错误响应体与 OpenAI 官方保持一致：
{
"error": {
"message": "余额不足",
"type": "insufficient_quota",
"code": "insufficient_user_quota",
"param": null
}
}
HTTP 状态码
| 状态码 | 含义 | 处理 |
|---|
| 200 | 成功 | — |
| 400 | 请求体格式错误 / 参数非法 | 核对 JSON 字段、模型名拼写 |
| 401 | 未鉴权（缺失或非法 Key） | 检查 Authorization 头 |
| 402 | 余额不足 / 令牌额度用尽 | 充值或提高令牌额度 |
| 403 | 模型未授权 | 在令牌设置里勾选该模型，或切换分组 |
| 404 | 端点或模型不存在 | 对照 API 参考 的路径 |
| 429 | 触发限速 | 读取响应头 Retry-After，指数退避重试 |
| 500 | 网关内部错误 | 携带 X-Request-Id 联系支持 |
| 502 | 上游渠道异常 | 切换分组 / 模型或稍后重试 |
| 503 | 上游过载 | 重试或降级模型 |
| 504 | 上游超时 | 缩短输入，或切换 mini/flash 模型 |
业务错误类型
| type | 含义 |
|---|
invalid_request_error | 请求参数非法 |
authentication_error | 鉴权失败 |
permission_denied | 无权限访问该资源 |
insufficient_quota | 余额不足 |
rate_limit_error | 被限流 |
upstream_error | 上游厂商返回错误 |
server_error | 网关自身错误 |
content_filter | 内容审查拦截（多为上游返回） |
排查步骤
- 记录响应头
X-Request-Id 与发生时间（UTC）。
- 登录 控制台 · 日志，按 Request ID 搜索。
- 查看日志行里的
channel / upstream_status / error。
- 常见：
channel disabled → 该渠道暂时熔断，切换分组即可；context_length_exceeded → 输入过长，换长上下文模型；invalid_api_key → 令牌已被吊销或 URL 写错。
- 仍无解时带着 Request ID 到「联系支持」提交工单。
重试策略建议
- 幂等请求遇到
429 / 502 / 503 / 504 可安全重试。
- 指数退避起步 0.5s，上限 16s，最多 5 次。
- 对
429 优先读取 Retry-After 头。
- 不要对
400 / 401 / 402 / 403 重试，属于业务错误。