# 排查一次请求

先定位失败环节，再决定是否重试。

<a id="inspect"></a>

## 保留排查信息

保留 HTTP 状态、响应体、模型 ID、分组、时间和请求或任务 ID。分享日志前移除 Authorization 等密钥内容；不同上游可能使用不同错误码，要结合消息判断。

<a id="diagnose"></a>

## 常见失败情况



| 现象 | 检查方向 |
| --- | --- |
| 鉴权失败 / 401 | 本站密钥、Bearer 请求头、密钥是否失效。 |
| 权限错误 / 403 | 账户权限、模型分组和允许使用的模型。 |
| 参数错误 / 400 | JSON 格式、准确模型 ID、接口与支持参数。 |
| 地址错误 / 404 | 重复 /v1、错误操作路径或不存在的任务。 |
| 额度或限流 / 429 | 余额、分组限制及上游限流。 |
| 超时 / 5xx | 重试前检查已保存任务 ID 与控制台处理结果。 |

<a id="retry"></a>

## 有边界地重试

鉴权或参数错误应修正后再提交。临时故障使用有上限的退避，并遵循响应中的 Retry-After（如有）。新的生成 POST 可能产生另一笔计费操作，本接口说明不承诺通用幂等保证。

视频优先查询原任务 ID，终态后停止轮询。流式中断应保留已收到内容，并在应用中明确显示失败。