常见错误
接入 sub2aigc 后，如果客户端返回错误，可以先对照下表排查。建议先确认 Base URL、API Key、模型名称是否正确，再结合错误码和 error_message 定位原因。
错误码速查
| 错误码 | 错误信息（error_message） |
说明 |
|---|---|---|
400 / api_error |
API key group platform is not gemini |
API Key 所属平台与请求接口不匹配。Gemini 接口需要使用对应平台的 Key。 |
401 / api_error |
User account is not active |
账号未激活或已停用，请检查账号状态。 |
403 / api_error |
This group is restricted to Claude Code clients (/v1/messages only) |
当前分组仅允许 Claude Code 客户端访问。请改用 Claude Code，或更换支持当前客户端的分组和 Key。 |
403 / api_error |
Access denied. Your IP is <ip> |
当前 IP 被限制访问。如确认网络正常仍持续出现，请联系管理员核查。 |
404 / api_error |
Model "<name>" is not supported by any configured account in this group |
当前分组不支持该模型。请核对完整模型名称、大小写和分组。 |
429 / rate_limit_error |
Too many pending requests, please retry later |
短时间内并发请求过多，请降低并发或稍后重试。 |
500 / api_error |
All available accounts exhausted |
当前服务资源紧张，暂时无法处理请求，请稍后重试。 |
502 / api_error |
Upstream request failed |
上游服务暂时不可用，请稍后重试。 |
502 / api_error |
Upstream stream ended without a response |
响应开始前连接中断，请重新发起请求。 |
503 / api_error |
No available accounts: this group only allows Claude Code clients |
当前分组仅允许 Claude Code 客户端访问。请改用 Claude Code，或更换分组和 Key。 |
200 / api_error |
Recovered upstream error 502/403/429/500 |
流式响应中途发生错误，收到的内容可能不完整，请重新请求。 |
排查建议
- 核对配置：确认 Base URL、API Key、模型名称与控制台一致。
- 判断错误类型：4xx 通常与请求、账号或分组配置有关；5xx 通常是服务端临时状态。
- 控制重试频率：遇到 429、503 时不要连续高频重试，建议逐步延长重试间隔。
- 保留错误现场：问题持续时，记录请求时间、错误码和完整
error_message，方便定位。
更多基础配置问题可查看 常见问题。