这次实际调用拿到了什么
同一个任务 ID 经查询达到 succeeded，返回视频已下载为可检查的 MP4。提交、查询与下载链路已跑通；无声参数没有符合本次结果，记录为部分验证。
- 任务终态
succeeded，已下载 MP4
- 视频规格
720×720 · H.264 · 4.096009 秒
来自下载文件的媒体探测；请求时长为 4 秒。
- 文件大小
2,072,628 bytes
- 返回用量
86,222 completion token
记录接口返回 usage；不据此直接认定实际实扣。
- 音频验收
未通过：实收非静音 AAC
请求 generate_audio=false；ffmpeg 解码检测平均 -27.6 dB，峰值 -11.8 dB。
- 实际实扣
未核实
实际请求为 4 秒、720p、1:1、generate_audio=false。实收含非静音 AAC 音轨，无声验收未通过。画面仅人工检查选帧，保持单只鲸鱼可见，不代表全片细节不变。客户端查询没有重复创建该任务；本次实际账单未能核实，billed_usd 留空。
记录日期：2026-10-07。这是单次任务记录，其他输入、分组与参数的结果需要单独验证。
这次任务准备什么
- 首帧素材
- 自己有权使用的图片，放在外部可直接读取的 HTTPS 地址。替换模板中的 YOUR-PUBLIC-IMAGE-HOST；本地文件路径不能用作远程 URL。
- 动作与镜头
- 保持主体外观与数量，镜头缓慢推进，不增加物体、不切换场景。示例使用 1:1、4 秒、720p、无声；参数需要当前通道验证。
- 执行条件
- Python 3.10+、准确模型权限及足够额度。开始前按当前文档和分组核对首帧、比例、时长与价格。
最终保留：任务 ID + 查询结果 + MP4 文件 + 验收记录
视频创建参数与成片规格验收
本站绘制的内容说明图：本页首帧视频请求示意；创建与查询对应同一任务 ID，succeeded 之后仍须下载并验收音画。
本站绘制的内容说明图：本页 2026-10-07 实际视频的媒体探测要点：提交、查询与下载已完成，但无声要求未通过，真实账单未匹配。
从输入到可检查的结果
脚本在自己的电脑运行。API Key 只放在本地环境变量中；预览与正式调用分开，实际费用到控制台核对。
1.准备请求与可读取的首帧
下载请求 JSON 和两个 Python 脚本。替换图片地址并核对参数；这个模板只展示一张首帧图，不包含音频或多素材任务。
请求结构示意；下载模板后替换图片地址
{ "model": "doubao-seedance-2-0-260128", "content": [ { "type": "text", "text": "保持主体外观与数量，镜头缓慢推进，不切换场景。" }, { "type": "image_url", "image_url": { "url": "https://YOUR-PUBLIC-IMAGE-HOST/input.png" }, "role": "first_frame" } ], "ratio": "1:1", "duration": 4, "resolution": "720p", "generate_audio": false }2.只提交一次，保存任务 ID
在本地安全设置 tokenba_API_KEY。这个命令会创建任务并可能计费，随后查询状态。video-task.json 必须是新文件；请保留它。POST 超时可能已经创建成功，先查任务历史。
终端
python3 seedance-task.py create --api seedance-2 --payload tokenba-case-video-request.json --state video-task.json > video-result.json3.超时后恢复查询，不重新创建
等待超时不会取消远程任务。有任务 ID 时用原状态文件继续 GET 查询。脚本只对查询的 429 与 5xx 等情况等待重试，设置总等待上限；失败与未知状态停止检查。
终端
python3 seedance-task.py query --state video-task.json > video-result.json4.下载 MP4，播放后再验收
succeeded 结果应包含 HTTPS video_url。先预览下载步骤，再单独保存 MP4。下载器不发送 API Key、不跟随重定向，检查文件容器签名；完整播放和画面验收由你完成。
终端
python3 tokenba-case-runner.py download-video --result video-result.json python3 tokenba-case-runner.py download-video --result video-result.json --run --out video-output
怎样算完成
保留同一个任务 ID；区分 queued、running、succeeded 和失败状态，未完成时不记录成功。
下载结果能正常播放，时长与构图符合参数；主体外观、数量和场景符合要求。
保存视频、任务 ID、参数、usage 与控制台实扣。临时链接应及时下载，不能视为永久素材地址。
验证范围与限制
2026-10-07 的实际任务完成并下载，但无声要求没有通过：请求 generate_audio=false，实收视频仍含非静音 AAC 音轨。画面只人工检查了选帧，不能保证全部细节不变。
首次 2 秒、480p 的组合请求返回 HTTP 400，没有任务 ID；4 秒、720p 组合创建成功。不能将首次拒绝归因于某一个字段，参数支持需要当前通道验证。Seedance 2.0 使用 /api/v3，旧版路径与其他厂商的状态、参数分别核对。
脚本不会因生成失败自动创建新任务。本次实际账单尚未核实；失败、过期、取消和等待超时的费用规则需按控制台与通道分别核对，不能统一保证免费。
示例更新：2026-10-07。公开内容为任务材料、请求和验收方法；离线脚本检查与付费模型实测分别记录。
常见问题
Seedance 创建视频任务超时后应该直接重新生成吗？
先查看状态文件和任务历史。POST 超时可能已经创建任务，有任务 ID 就恢复查询；重复创建可能产生额外费用。
Seedance MP4 下载成功后还要验收哪些内容？
下载脚本只确认基本容器签名。还需要播放文件，检查时长、构图、动作、主体一致性和实际账单，才能判断是否符合任务目标。
提交超时了，直接再生成一次吗？
先查看状态文件和任务历史。POST 超时可能已经创建任务，有任务 ID 就恢复查询；重复创建可能产生额外费用。
MP4 下载成功就代表任务通过了吗？
下载脚本只确认基本容器签名。还需要播放文件，检查时长、构图、动作、主体一致性和实际账单，才能判断是否符合任务目标。
这个实际视频符合无声要求吗？
没有通过。请求使用 generate_audio=false，但返回 MP4 含 AAC 音轨；解码检测平均 -27.6 dB、峰值 -11.8 dB，存在实际声音。页面播放器默认静音，文件本身不是无声。正式接入前需要核对当前通道的音频参数处理。