常见问题

如何创建 API Key？

登录后进入 Key 管理 页面，点击「新建 Key」并输入名称即可。创建成功后请立即复制完整 Key，关闭弹窗后将不再完整显示。

API 返回 429 怎么办？

429 表示当前请求触发了速率限制或配额不足。常见原因：

• 并发超限：同一时刻请求数超过套餐或供应商限制，降低并发即可恢复。
• 配额耗尽：订阅套餐额度用尽或免费额度用尽，需购买套餐或充值钱包。
• TPM/RPM 限制：每分钟 Token 数或请求数超限，等待窗口滚动后自动恢复。

可在 请求日志 页面查看具体状态码与错误信息。若底层 Key 因配额耗尽被临时禁用，会在刷新时间后自动恢复。

API 返回 401/403 怎么办？

• 401：API Key 无效或已过期，请检查 Key 是否正确。
• 403：账号被限制访问（如违规终止、未在白名单等），请联系管理员。

API 返回 400 怎么办？

400 通常表示请求参数错误，常见原因：

• 缺少必填字段（如 model、messages）
• 上下文过长（超出模型的上下文窗口）
• 请求格式不符合协议规范

请对照 API 接入 检查请求格式。

API 返回 500/503 怎么办？

5xx 为上游供应商服务端错误，常见原因：

• 供应商模型服务暂时不可用
• 供应商内部错误或请求超时

这类错误与客户端无关，系统会自动重试或切换备用 Key。持续出现请联系管理员。

常见错误码速查

以下错误分类与数据库 supplier_error_codes 表同步：

分类	含义	常见 HTTP 状态码
auth_error	认证失败（Key 无效/过期）	401
access_denied	访问被拒（违规/未授权）	403
rate_limit	速率限制（并发/TPM超限）	429
quota_exhausted	配额耗尽（额度用尽）	429
billing_issue	计费问题（欠费/到期）	429
content_filter	内容安全过滤	400/403
invalid_request	请求格式错误	400/404
server_error	供应商服务端错误	500/503
client_error	客户端参数错误	400

为什么请求日志里看不到最新记录？

日志写入存在秒级延迟，刷新页面或等待片刻即可。若长时间无记录，请检查 API Key 是否正确、请求是否到达网关。

如何查看剩余额度？

• 订阅用户：登录后在页面顶部或 设置 页面查看当前套餐的剩余额度与到期时间。
• 按量用户：登录后在 钱包 页面查看余额与消费记录。

支持哪些协议？

支持 OpenAI 兼容协议（/v1/chat/completions）与 Anthropic 兼容协议（/v1/messages）。

可以申请发票吗？

可以。在 发票 页面填写开票信息并选择已支付订单提交申请，管理员审核通过后即可下载电子发票。