错误码与排查

本页列出用户最常遇到的问题和排查方向。

401 Unauthorized

常见原因：

• API Key 错误或已删除。
• 请求头没有使用 Authorization: Bearer YOUR_API_KEY。
• Claude 兼容接口没有使用 x-api-key。
• 复制 API Key 时多了空格或换行。

余额不足

常见原因：

• 账户余额不足。
• 套餐已过期。
• 当前分组额度不足。

处理方式：登录控制台查看余额、套餐和充值记录。

模型不存在

常见原因：

• 模型名拼写错误。
• 当前账号没有权限使用该模型。
• 模型暂时被管理员下线。

处理方式：查看控制台模型列表或调用：

curl https://ccwai.tech/v1/models \
  -H "Authorization: Bearer $CCWAI_API_KEY"

请求格式错误

常见原因：

• Chat Completions 和 Responses 请求体混用。
• JSON 格式错误。
• 图片或音频接口缺少文件字段。
• 参数不被当前模型支持。

处理方式：先使用文档中的最小示例跑通，再逐步增加参数。

限流

常见原因：

• 短时间请求过多。
• 单个模型或单个 Key 达到频率限制。

处理方式：降低并发、增加重试间隔，或联系支持调整限制。

上游错误

常见原因：

• 上游模型服务暂时不可用。
• 上游返回内容过滤或参数错误。
• 渠道路由失败。

处理方式：换一个模型重试，或在控制台日志中查看错误详情。