帮助与维护 · 更新于 2026-09-08
常见问题与排障
| 401 | 检查密钥、认证头、到期/停用状态以及是否把登录凭证当成 API Key |
|---|---|
| 403 / 模型不允许 | 核对账户状态、模型支持范围、密钥权限与套餐范围 |
| 402 / 额度不足 | 检查该密钥的计费方式、可用额度和冻结额；上游余额不能代替用户额度 |
| 404 / 路由不支持 | 核对 Base URL、是否重复 /v1，以及模型支持的协议 |
| 429 | 检查 RPM、并发、密钥额度策略或上游限流，使用退避重试 |
| 502 / 503 / 504 | 核对平台状态、上游错误、Adapter 进程与网络；携带请求 ID 排查 |
错误码会因上游与客户端封装有所不同，以响应 error 和平台请求记录为准。不要无限重试付费请求，也不要为了绕过权限不断生成新密钥。
提交问题时提供
- 发生时间、客户端名称与版本、操作系统。
- 模型精确 ID、接口路径、是否流式、HTTP 状态及 Trace / Request ID。
- 脱敏错误信息和最小复现步骤，绝不附真实密钥或短信验证码。