错误码说明
当请求失败时,服务会返回 HTTP 状态码与错误提示。以下为常见错误:
| 状态码 | 含义 | 建议处理 |
|---|---|---|
| 400 | 请求参数不合法 | 检查请求体格式与必填字段 |
| 401 | 未授权或密钥无效 | 检查 API Key 是否正确 |
| 403 | 权限不足或被拒绝 | 检查账号权限、额度或审核规则 |
| 404 | 接口不存在 | 确认请求路径与方法 |
| 429 | 请求过快或额度不足 | 降低频率或补充额度 |
| 500 | 服务异常 | 稍后重试或联系支持 |
| 502/503 | 上游不可用 | 稍后重试或切换模型 |
排查步骤
- 先检查认证与模型名称是否正确
- 再确认请求体字段是否完整
- 若持续失败,记录请求时间与返回信息联系支持