常见错误

这里仅整理当前接口文档中已经出现的问题，不额外编造具体错误码。没有明确错误码时，用“可能表现为 400 / 401 / 403 / 404 / 超时”描述。

问题	可能表现	排查方式
API Key 缺失或格式错误	401	检查是否携带 `Authorization: Bearer sk-your-token`，并确认密钥完整保留 `sk-`。
令牌禁用、过期或 IP 受限	401 / 403	到令牌管理查看启用状态、过期时间、IP 限制和模型限制。
账户余额不足	403 或请求失败	到钱包确认余额、充值记录和消费变化。
模型不存在或无权限	403 / 404	用“查询可用模型”接口确认当前令牌能看到目标模型。
参数格式不正确	400	检查请求体字段是否属于当前协议，例如 Gemini 使用 `contents`，OpenAI Chat 使用 `messages`。
请求超时	超时	高分辨率图像、视频任务、长文本或上游响应慢时可能出现，异步任务请到任务日志查询状态。