错误与重试
先判断请求是否已经提交,再决定修正参数、等待或重试。
常见情况
| 情况 | 建议处理 |
|---|---|
| 401 | 检查 Key 是否填写正确、有效且未过期。 |
| 403 / model_not_found | 检查模型权限和会员条件,不要反复生成。 |
| 429 | 按服务端提示退避,降低并发。 |
| generation_pending | 任务仍可能执行,保留原幂等键。 |
| 报价失效 | 重新报价,使用新 quote_id 提交。 |
| 流式连接中断 | 按任务 ID 查询或重新连接事件流。 |
保留诊断信息
记录请求时间、接口、HTTP 状态、错误代码和任务 ID,提交问题时先去掉 API Key 与私人素材。不要只记录「生成失败」。
