展开本页目录
开始前准备什么
- 原始请求的型号、路径、参数、提交时间和脱敏错误码。
- 已返回的 task_id，以及自己可访问的任务历史与用量日志。
- 素材原文件与成片，分享记录前移除 Key、签名素材地址和敏感内容。
- 识别阶段
- 保留证据
- 核对参数与素材
- 恢复原任务
- 验收与核账
已有 Python 客户端：创建一次、保存状态文件，再按同一 task_id 查询；创建可能计费。
两条未提交的虚构任务，可导入本地记录工具；费用未知，不含 Key 或实际任务 ID。
先用 task_id 判断下一步
| 现象 | 当前判断 | 下一步 |
|---|---|---|
| 创建返回明确 4xx，未返回 ID | 请求被拒，保留错误码 | 查鉴权、权限、路径和完整参数 |
| POST 超时或断连，未返回 ID | 提交结果 unknown | 核对任务历史和日志，再人工决定 |
| 有 task_id，queued / running | 任务尚未结束 | 按原 ID 限时查询 |
| 有 task_id，failed / expired / cancelled | 远端明确终态 | 记录错误与费用，修改后另建新版本 |
| succeeded，文件无法用 | 生成与交付验收分开 | 检查下载、解码、尺寸、内容与声音 |
- 现象
- 创建返回明确 4xx，未返回 ID
- 当前判断
- 请求被拒，保留错误码
- 下一步
- 查鉴权、权限、路径和完整参数
- 现象
- POST 超时或断连，未返回 ID
- 当前判断
- 提交结果 unknown
- 下一步
- 核对任务历史和日志，再人工决定
- 现象
- 有 task_id，queued / running
- 当前判断
- 任务尚未结束
- 下一步
- 按原 ID 限时查询
- 现象
- 有 task_id，failed / expired / cancelled
- 当前判断
- 远端明确终态
- 下一步
- 记录错误与费用，修改后另建新版本
- 现象
- succeeded，文件无法用
- 当前判断
- 生成与交付验收分开
- 下一步
- 检查下载、解码、尺寸、内容与声音
本站绘制的内容说明图：视频创建失败、查询未结束、文件不可用是不同分支；没有 ID 的超时不能自动当可免费重发的失败。
400 不等于只改一个参数就能解决
先确认型号、完整端点、图片角色与当前通道要求一致。远程素材地址必须指向可读取的文件；登录页、临时失效链接和本地文件路径都要排除。逐项记录修改前后，避免同时换很多字段。
历史测试中，2 秒加 480p 的组合请求返回 HTTP 400，没有任务 ID；改为 4 秒加 720p 后创建成功。这只能说明两个组合的结果不同，不能认定某一个字段是唯一原因，更不能推广到所有 Seedance 型号。
text
Seedance 2.0 当前接入路径：
https://api.apizt.com/api/v3/contents/generations/tasks
记录：model、content roles、ratio、duration、resolution、generate_audio
同时保留：提交时间、HTTP status、脱敏 error.code、request_id、task_id
不保留到公开工单：Authorization、API Key、签名素材 URL有 ID 就恢复查询，不回到创建节点
查询截止时间到达，远端任务不一定被取消。用已保存的状态文件继续 GET；网络不通、查询 429 或 5xx 也不能证明任务生成失败。客户端需设置间隔与总时限，不无限轮询。
原有 Python 客户端只对查询的 429 与 5xx 等情况等待重试，创建不会自动重提。发现未知状态或缺少可用结果地址就停止检查；任务失败时也先保留证据，不自动排队创建新任务。
bash
python3 seedance-task.py query --state original-video-task.json --timeout 600 --interval 5 > original-video-result.json
本站绘制的内容说明图：本页恢复命令只继续 GET 查询；创建请求无自动重提，查询失败也不能证明生成失败。
succeeded 以后，继续检查交付文件
结果没有可用 HTTPS 视频地址时，保留任务状态并核对响应；地址失效或下载错误属于交付问题，先尝试恢复原结果，不自动再生成。下载视频无需携带 API Key 到素材域名。
拿到 MP4 后检查真实尺寸、时长、解码和音轨，再完整播放。无声要求要看实际文件，播放器默认静音不会移除音轨；历史样本就出现 generate_audio=false 但实收非静音 AAC 的情况。
用一份脱敏记录定位和核账
向支持提交同一任务的时间、型号、ID、错误码和关键参数，另附不含敏感信息的文件探测结果。API 状态、下载状态和验收状态分别记录，便于判断问题是否已经解决。
费用规则不能按 failed、expired 或本地超时统一推断。查看这条任务的实际用量与扣费；未确认时保留 unknown。重做任务也要保留旧 ID，避免只看到最后成功的一次。
怎样确认已经完成
- 失败阶段已区分，POST 结果未知未误判为未创建。
- 已有 task_id 始终用于原任务查询，没有自动重提。
- 参数和素材修改有版本记录，保留错误码与提交时间。
- 任务终态、文件验收与真实费用分别核对。
常见问题
生成超时可以直接再提交吗？
先确认是 POST 超时还是 GET 等待到期。POST 可能已创建任务；已有 task_id 就查询原任务，没有 ID 就先查历史和日志。
失败任务一定不会扣费吗？
不能统一保证。不同通道和任务状态的计费规则需核对实际账单，费用未确认时记录 unknown。
生成成功但视频有声音，属于接口失败吗？
任务状态可以是 succeeded，但无声验收失败。分别记录生成终态与实际音轨，核对当前通道参数处理和交付要求。