API 错误码参考
了解常见错误及其解决方法
4xx 客户端错误
请求格式或权限问题
400
请求无效
请求体格式错误或缺少必要字段（如 model 或 messages）。
401
认证失败
API Key 缺失、无效或已过期。请检查 Authorization 头是否为 Bearer 格式。
403
权限不足
例如免费模型调用次数已达上限，或 IP 被限制。
404
资源不存在
请求的接口路径或模型不存在。请检查 URL 和模型名称。
409
资源冲突
例如注册时用户名已存在，或创建密钥超过限制（最多 3 个）。
429
请求过于频繁
您发送的请求过多，请稍后重试。
5xx 服务器错误
上游或系统内部问题
500
服务器内部错误
系统发生未预期错误，请联系管理员或查看日志。
502
上游网关错误
中转站与上游 AI 服务通信失败，请稍后重试。
503
服务暂时不可用
上游服务过载或维护中，请稍后重试。
504
上游超时
上游响应超时，请尝试缩短输入或稍后重试。
常见问题排查
- ✅ 确认 API Key 已正确复制，且未过期。
- ✅ 确认请求头包含
Authorization: Bearer sk-你的密钥。 - ✅ 确认请求体为合法 JSON，且包含
model和messages字段。 - ✅ 若模型报错，请确认模型名称与模型商城中列出的完全一致（包括大小写和斜杠）。
- ✅ 若频繁超时，请检查网络或稍后重试。