先确认是哪一步失败
创建失败先检查 HTTP 状态与错误正文；创建成功后以任务状态为准。请记录本站任务 ID、模型、提交时间和脱敏后的参数，排查时不要提供 API Key。
| 现象 | 处理方法 |
|---|---|
| 401 / 鉴权错误 | 检查青云TOP API Key、Bearer 空格和 Key 状态；不能使用 MiniMax Key 替换本站 Key |
| 模型不可用 / 无可用渠道 | 核对模型大小写、Key 的模型权限及额度；请确认当前 API Key 已获对应模型的访问权限 |
| 参数不合法 | 检查时长与分辨率组合；Fast 必须带图；H3 为4–15秒且仅768P/2K |
| 图片无效 / 下载失败 | 使用公网文件直链，检查格式、大小和尺寸；不要传本机路径或需登录的网页 |
| H3 素材冲突 | first_frame / last_frame 与 reference_* 不能混用，必须含非空 text |
| 429 / 上游限流 | 按 Retry-After 或指数退避查询；不要批量重建任务 |
| failed 但没有 error | 响应中可能没有完整失败详情，保存任务 ID 联系支持 |
| 网络超时 | 先用已保存 ID 查询；不要盲目重发创建请求 |
MiniMax 常见上游码包括 1002（限流）、1004/2049（上游鉴权）、1008（上游余额）、1026（内容限制）、2013（参数异常）。它们不等同于本站 HTTP 状态；出现上游鉴权或余额问题时，应提交任务 ID 给支持排查，不要求调用者填写上游密钥。
回调是可选项
在 metadata.callback_url 填公网 HTTPS 地址，用于接收 MiniMax 发送的状态通知。传统视频官方会先发送含 challenge 的 POST；服务端需在3秒内返回包含同值 challenge 的 JSON。通过验证后接收状态通知。
回调来自模型服务，可能使用与本站不同的任务号；不要把它直接代入本站查询路径，也不要假设其签名或重试规则与本站查询相同。建议以本站轮询结果为准。接收回调时应验证来源、幂等处理，并关联自己保存的请求记录。