常见问题

401：认证失败

确认请求头为 Authorization: Bearer <API_KEY>，Key 没有多余空格，且未被禁用、删除或过期。

403：没有权限

检查 Key 的分组、模型白名单和 IP 白名单。Key 绑定的分组必须仍在用户所属分组中。

404：接口不存在

通常是 Base URL 拼接错误。OpenAI SDK 一般填写包含 /v1 的地址；不要形成 /v1/v1/chat/completions。

429：请求过多

请求触发了 RPM、TPM、RPD 或上游限流。降低并发并使用带随机抖动的指数退避。

余额或额度不足

同时检查账号额度和 API Key 额度。过大的 max_tokens 也可能使请求预估额度超过剩余额度。

5xx：服务异常

保存发生时间（含时区）、模型、端点、状态码和请求标识后联系管理员。不要发送完整 API Key 或敏感正文。