# 错误与重试

先判断请求是否已经提交，再决定修正参数、等待或重试。

## 常见情况

| 情况 | 建议处理 |
| --- | --- |
| 401 | 检查 Key 是否填写正确、有效且未过期。 |
| 403 / model_not_found | 检查模型权限和会员条件，不要反复生成。 |
| 429 | 按服务端提示退避，降低并发。 |
| generation_pending | 任务仍可能执行，保留原幂等键。 |
| 报价失效 | 重新报价，使用新 quote_id 提交。 |
| 流式连接中断 | 按任务 ID 查询或重新连接事件流。 |

## 保留诊断信息

记录请求时间、接口、HTTP 状态、错误代码和任务 ID，提交问题时先去掉 API Key 与私人素材。不要只记录「生成失败」。