词元排错顺序：先看 HTTP，再看模型代号和任务类型。文本 429 和图片空响应、视频轮询超时不是同一类问题。保存 request ID 和脱敏请求，再找客服。
1. 快速分流
- 先看 HTTP 状态码，把问题归到鉴权、权限、限流还是上游。
- 再核对模型代号与任务类型：文本、图片、视频的排错路径不同。
- 保留 request ID 和脱敏后的请求记录，再动手改配置。
2. 错误码说明总表
| 码 | 含义 | 词元里优先查 |
|---|---|---|
| 401 | 鉴权失败 | Key 完整性、Bearer、是否把登录 Cookie 当成 Key |
| 403 | 无权限 | 分组有没有这个模型；Seedance 是否未开通 |
| 404 | 路径或模型不存在 | /v1 是否写了两次；模型 ID 是否手打错 |
| 429 | 限流或额度 | 余额、密钥额度、并发；不要按官方免费额度理解 |
| 5xx / 529 | 上游繁忙 | 缩短输入、降并发、记录时间窗后再重试 |
3. 401 与 403
401 是“你是谁”没答对：Key 复制不完整、多了空格、请求头字段用错，或者拿官方登录 Cookie 当 Key。重新生成一把 Key，用最短请求验证。403 是“你没资格”：Key 有效但分组不含该模型，或 Seedance 等开通类模型未开通。换分组、换模型或先走开通流程，重试解决不了 403。
4. 429 限流
429 不是封号。按顺序查：控制台余额 → 密钥单 Key 额度 → 并发数。确认超限后降并发、加退避间隔；连续 429 说明并发策略要改，不是多发几次能解决的。重试设上限（如 3 次），每次间隔翻倍。
5. 5xx 与上游繁忙
5xx / 529 表示上游或线路繁忙，和你的配置无关。处理：缩短输入、降低并发、换时间窗重试。不要在 5xx 期间无间隔轰炸重试，既浪费也加重拥堵。
6. 媒体任务额外规则
- 图片返回 200 但无图：当失败样本，核对是否扣了成功张数。
- 视频超时：先查任务状态，不要立刻重提。
- Grok/Gemini 生图约 0.01 元/张，GPT-image 约 0.03，看错代号会看不懂账单。
账单验收：文本记录输入/输出 Token，图片记录成功张数和尺寸，视频记录任务 ID、状态和成功扣费。只有“接口返回 200”而没有输出文件时，不要把请求当成成功样本。
7. 日志与最小复现记录
每次只改变一个变量：先用同一 Key、同一模型和最短输入复现，再分别替换模型、尺寸或并发。记录 Base URL、模型代号、状态码、响应片段、request ID、发生时间和余额变化；这样能区分客户端配置错误、额度问题和上游线路问题。提交给客服 QQ 49098022 或 Telegram 群组 时带：模型 ID、时间、HTTP、request ID。不要发完整 Key。
- 不要把完整 API Key、Authorization 头或用户 Prompt 发到群里。
- 不要在 429 或 5xx 时无间隔无限重试，先设置退避并确认是否已扣费。
- 不要把登录页面能打开当成 API 可用，登录 Cookie 与 API Key 是两套凭证。
8. 常见问题
401 但网页能登录？
登录态和 API Key 不是一回事。接口只用 Key。
429 是不是被封？
多数是额度或并发。先降速，核对余额，再决定是否换时间窗。
同一个报错为什么时好时坏？
大概率是 429/5xx 类动态问题。把成功和失败两次的 request ID 都记下来对比时间与余额。