常見問題
| 程式碼 | 含义 | 常见原因 | 處理建議 |
|---|---|---|---|
200 | 成功 | 正常回传;若内容为空或 SSE 无 data,可能是端點搭配错误 | 检查模型對應端點 |
400 | 請求格式错误 | JSON 非法、缺少必填项、模型名拼错、参数超范围 | 核对請求内容 |
401 | 未认证 | API 秘钥缺失、拼错、停用或网络问题 | 登录主控台确认秘钥状態 |
403 | 權限不足 | 没有對應模型或分組權限 | 查看分組權限或联系客服 |
404 | 路径或模型不存在 | URL 拼错或模型不可用 | 查看 /v1/models 并核对 URL |
413 | 請求内容過大 | prompt 或 input 超過上下文窗口 | 縮短输入或分段處理 |
429 | 限流 / 额度耗尽 | QPS 超限或余额不足 | 降低并發并查看额度 |
500 | 上游内部错误 | 上游模型服务异常 | 等 30 秒後重试 |
502 | 网关错误 | 中轉站到上游鏈路异常 | 等 1 分钟後重试 |
503 | 服务不可用 | 上游過载或维护 | 等 1-5 分钟後重试 |
504 | 网关超时 | 上游响应慢或 prompt 過长 | 縮短输入,啟用 stream |
524 | 超时 | Cloudflare 超时 | 建議多次尝试 |