排障参考
错误码
按认证、参数、额度、服务异常几类整理常见错误，方便快速定位是客户端问题还是服务端问题。
| 渠道 | 地址 |
|---|---|
| 身份验证 | /docs/support/authentication |
| 在线调试 | /docs/support/debug |
认证类
- - 401：Key 无效、缺失或已过期。
- - 403：Key 有效，但无权访问当前资源。
- - 优先检查请求头与授权方式是否正确。
参数类
- - 400：请求参数不完整或格式不合法。
- - 422：字段值合法，但不满足业务约束。
- - 优先核对模型名称、尺寸、时长与枚举值。
额度与资源类
- - 429：额度不足、触发速率限制或并发过高。
- - 404：路径或资源 ID 不存在。
- - 先确认调用的接口路径是否与文档一致。
服务异常类
- - 500：服务内部异常。
- - 502 / 503：上游服务波动或暂时不可用。
- - 建议先查看状态页，再重试一次。
说明
- - 如果同一错误反复出现，建议收集完整请求和响应后提交给支持渠道。
- - 错误码页面适合与 FAQ 联动使用，便于集中排查。