错误码说明

调用 API 时，如果请求失败，可以根据状态码快速判断问题方向。

常见状态码

状态码	含义	常见原因
400	请求格式错误	JSON 格式错误、参数不支持
401	鉴权失败	API Key 错误、缺少 Bearer
403	无权限	分组无权限、模型未开放
404	路径或模型不存在	接口路径错误、模型名称错误
429	请求受限	请求过快、额度不足、触发限制
500	服务异常	服务端或上游异常
502/503	网关或上游不可用	上游波动、网络异常

401 Unauthorized

请检查：

• 请求头是否包含 Authorization。
• 是否使用 Bearer sk-xxxx 格式。
• API Key 是否复制完整。
• API Key 是否已被删除或禁用。

403 Forbidden

请检查：

• 当前账号是否有该模型权限。
• API Key 是否限制了可用分组或模型。
• 模型是否对当前用户开放。

404 Not Found

请检查：

• Base URL 是否填写为 https://api.oskyi.com/v1。
• 接口路径是否正确。
• 模型名称是否与模型广场一致。

429 Too Many Requests

可能是请求过快、余额不足或触发限流。建议：

• 降低并发。
• 稍后重试。
• 检查账号余额。
• 检查是否有异常脚本持续请求。

500 / 502 / 503

这类错误通常与服务繁忙、上游异常或网络波动有关。建议稍后重试，或切换同类模型。

排查信息

联系管理员时，建议提供：

• 出错时间。
• 账号邮箱或用户 ID。
• 使用的模型。
• 请求接口。
• 错误截图或错误文本。
• 是否使用客户端、代码、代理或 CDN。