常见错误类型
- 认证失败
- 参数缺失或格式错误
- 配额不足或命中限流
- 上游模型服务异常
- 文件上传或媒体处理失败
推荐排查顺序
- 先检查认证头、密钥和环境变量
- 再检查请求参数结构和字段类型
- 然后确认是否命中限流、配额或模型不可用
- 最后回看服务端日志与请求追踪信息
接入建议
- 所有错误响应建议保留请求 ID
- 前端只展示用户可理解的信息，详细错误写入服务端日志
- 多模型网关场景下，建议把不同 provider 的错误统一映射为平台错误码
接口指南
错误码查询
API 指引中的错误码查询页，帮助快速定位请求失败原因。
错误码查询页用于帮助你在 API 调用失败时快速缩小排查范围。