错误码说明

快速对照

状态码	含义	处理方式
400	请求参数错误	检查 JSON、模型名、必填字段
401	鉴权失败	检查 API Key 和 Authorization
403	权限不足	检查模型权限、分组权限
404	资源不存在	检查接口路径和模型名
405	方法错误	确认使用 GET / POST / PUT / DELETE
413	请求体过大	减少上下文、图片或文件大小
429	请求过快	降低并发或检查限速
500	服务内部错误	查看日志，必要时联系管理员
503	上游不可用	稍后重试或切换分组
504	请求超时	降低任务大小或换稳定分组
524	网关超时	长任务建议使用异步接口

401 示例

错误请求：

Authorization: sk-logox-your-key

正确请求：

Authorization: Bearer sk-logox-your-key

404 示例

常见原因：

• /v1/chat/completion 少了 s。
• 模型名写错。
• 当前 Key 没有该模型权限。

429 示例

常见原因：

• 软件并发过高。
• 自动化工作流循环调用。
• Key 设置了限速。

处理方式：

• 降低并发。
• 增加重试间隔。
• 为高并发业务使用独立 Key。