错误码与排查

快速定位

现象	常见原因	处理方式
401 Unauthorized	API Key 错误、过期或被删除	重新复制 Key，确认没有多余空格。
403 Forbidden	Key 没有权限访问该模型组	换模型组或重新创建 Key。
404 model not found	模型 ID 填错或模型组不支持	到 模型与定价 复制模型 ID。
429 rate limit	并发、RPM、额度或上游限速	降低并发，稍后重试，或换模型组。
500 / 502	上游暂时不可用或网关错误	等待后重试；如果持续出现，联系管理员。
no available account	模型组没有可调度账号	检查订阅额度、账号状态或换组。

排查顺序

1. 确认 Base URL 是否正确。
2. 确认 API Key 是否属于当前账号。
3. 确认模型 ID 是否存在。
4. 确认 Key 创建时选择的模型组支持该模型。
5. 确认余额或订阅额度是否足够。
6. 换一个更基础的模型测试，例如 gpt-4o-mini 或 gemini-2.5-flash。

联系管理员时提供什么？

请提供：

• 请求时间
• 使用的模型 ID
• 使用的模型组
• 客户端名称
• 错误信息截图或返回 JSON
• 不要公开完整 API Key，只提供前后几位即可