Protokener / DOCUMENTATION
常见问题与排障
示例使用占位密钥；模型与价格以实时目录为准。
| 401 | 停止重复请求。普通 API 调用应重新复制有效 API Key；CodeBuddy / WorkBuddy 应完全退出客户端，在 API 密钥页选择有效主密钥，重新下载完整配置包并运行 install。模型显示恢复工具不会更换失效凭证 |
|---|---|
| 403 / 模型不允许 | 核对账户状态、模型支持范围、密钥权限与套餐范围 |
| 402 / 额度不足 | 查看当前模式的可用积分。订阅模式检查整期剩余积分和到期时间；已主动开启流量积分续用时再检查流量积分。上游余额不能代替用户额度 |
| 404 / 路由不支持 | 核对 Base URL、是否重复 /v1，以及模型支持的协议 |
| 429 | 检查 RPM、并发、密钥额度策略或上游限流，使用退避重试 |
| 502 / 503 / 504 | 核对平台状态、上游错误、Adapter 进程与网络；携带请求 ID 排查 |
错误码会因上游与客户端封装有所不同，以响应 error 和平台请求记录为准。不要无限重试付费请求，也不要为了绕过权限不断生成新密钥。
提交问题时提供
- 发生时间、客户端名称与版本、操作系统。
- 模型精确 ID、接口路径、是否流式、HTTP 状态及 Trace / Request ID。
- 脱敏错误信息和最小复现步骤，绝不附真实密钥或短信验证码。
资料来源：front/docs-content/pages.json · troubleshooting