图生视频工作流
从素材准备到任务查询，检查每一步的状态与结果。
阅读文章正在打开页面…
正在加载内容，请稍候。
Seedance 2.0 API：视频创建、任务查询与计费
Seedance 2.0 API 使用 /api/v3 的任务创建与查询流程。先确认完整版本 ID 和素材参数，收到响应保存任务 ID；等待超时后核对原任务再继续查询。
全球顶尖大模型 · 一站式接入
查看型号与视频计费型号与视频参考价格
视频生成采用任务流程。打开创作工作台后，请手动选择准确型号 doubao-seedance-2-0-260128。价格随分辨率、素材输入和计费档位变化；每百万 Tokens 单价不能直接当作每段视频的价格。
Seedance 2.0
doubao-seedance-2-0-260128创建并查询视频生成任务
保留目录中的完整版本 ID，按接口文档核对素材、时长与分辨率。
当前最低参考价
$4.32 / 百万 Tokens
4K · 包含视频输入
这是档位单价，非每段视频总价。
价格读取自公开模型目录，使用 5 分钟缓存。页面读取于 2026-11-06 11:07:53 UTC。最低参考价不代表当前令牌已获得相应权限；实际扣费以请求时价格和控制台记录为准。
视频任务从创建到验收
本站绘制的内容说明图：本家族列出的准确 ID 与任务入口；按共同任务验收，不把排序当作性能排名。
本站绘制的内容说明图：区分 SDK Base URL 与完整请求路径；只展示本页实际配置，不推定客户端和所有工具功能已经可用。
选对协议，再接入
视频接口先创建任务，再查询状态。先核对完整文档与计费档位，再运行示例。
- 创建视频任务
POST https://api.apizt.com/api/v3/contents/generations/tasks提交所选型号和 content，收到响应后保存任务 ID。创建请求可能产生费用；超时后先检查已保存任务，避免反复提交。
- 查询任务状态
GET /api/v3/contents/generations/tasks/{task_id}使用创建接口返回的任务 ID 继续查询。Seedance 2.0 的 /api/v3 流程与旧版 /volc/v1 不可混用，完成后再读取结果。
创建一条短视频任务
先在本地设置 tokenba_API_KEY。运行会提交视频任务并可能产生费用，收到响应后保存任务 ID；素材与时长范围以完整文档和当前通道为准。
curl --fail-with-body --max-time 120 \
https://api.apizt.com/api/v3/contents/generations/tasks \
-H "Authorization: Bearer $tokenba_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-0-260128",
"content": [{"type": "text", "text": "一只猫在阳光下打盹的温馨画面"}],
"ratio": "16:9",
"duration": 5
}'用已保存的任务 ID 查询状态
将 TASK_ID 替换为创建响应中的任务 ID。生成尚未完成时继续查询，不要重复创建同一任务。
curl --fail-with-body --max-time 30 \
"https://api.apizt.com/api/v3/contents/generations/tasks/TASK_ID" \
-H "Authorization: Bearer $tokenba_API_KEY"用途与使用边界
先做一条短任务
固定提示词和素材，保存型号、参数、任务 ID 与生成结果，再检查画面内容和实际费用。需要图生视频或视频输入时，按照当前接口文档核对素材格式与参数。
创建、查询和扣费分别检查
创建响应不等于视频已经完成。应用应处理进行中、失败和超时状态，保存任务记录；视频档位单价也不能替代一次完整生成的实际账单。
常见问题
Seedance 2.0 API 的视频参考价等于每段实际费用吗？
不能。本页保留价格目录的计费单位和档位；视频费用还与分辨率、时长和输入素材有关。每百万 Tokens 单价不是固定每段视频价格，完整规则与实扣请在模型广场和控制台核对。
Seedance 2.0 API 创建任务后为什么没有立即拿到视频？
保存创建响应中的任务 ID，使用查询接口查看状态，再读取完成结果。任务提交与结果生成是两个步骤，不要因为暂未完成就重复创建付费任务。
视频参考价能直接理解为每次生成费用吗？
不能。本页保留价格目录的计费单位和档位；视频费用还与分辨率、时长和输入素材有关。每百万 Tokens 单价不是固定每段视频价格，完整规则与实扣请在模型广场和控制台核对。
创建任务后没有立即拿到视频怎么办？
保存创建响应中的任务 ID，使用查询接口查看状态，再读取完成结果。任务提交与结果生成是两个步骤，不要因为暂未完成就重复创建付费任务。
创建请求超时后应该重新提交吗？
先检查已保存的响应、任务 ID 和控制台记录。已有任务 ID 时继续查询；无法确认是否创建成功时先核对任务记录，避免重复扣费。
可以直接在网页中使用吗？
可以进入 apizt 创作工作台，核对当前可选视频型号和参数。开发者也可按照本页任务示例与完整接口文档接入自己的应用。
从任务 ID 到视频文件，再核对费用
复用本站已有的提交、轮询与下载脚本。当前目录可见 doubao-seedance-2-0-260128；素材限制、时长和分组规则分别核对，提交成功不是生成完成。
- 任务状态
- 创建成功
- 要保存的证据
- 任务 ID 与提交时间
- 处理方式
- 继续查询该 ID，避免重复提交
- 任务状态
- 排队 / 执行中
- 要保存的证据
- 查询响应与间隔
- 处理方式
- 按文档轮询，超时后先查原任务
- 任务状态
- 成功
- 要保存的证据
- 终态、产物 URL、文件与输出参数
- 处理方式
- 实际下载并检查视频，及时保存
- 任务状态
- 失败
- 要保存的证据
- 错误码、终态和后台扣费记录
- 处理方式
- 核对是否实扣，不推断一定退款或免费
- 任务状态
- 本地超时 / submission_unconfirmed
- 要保存的证据
- 保存 state 文件、提交时间与原任务 ID；未确认提交结果先查控制台
- 处理方式
- 同一任务用 query 恢复；本地超时既不表示远端取消，也不表示可以安全重发
- 任务状态
- 产物与费用验收
- 要保存的证据
- 下载后核对可播放、实际时长、尺寸、音频与素材一致性；按 ID 对齐实扣
- 处理方式
- 按具体档位和计费单位核算，不把每百万 Tokens 单价写成固定每条视频价格
复用完整脚本，不重新造流程
- 下载 seedance-task.py，先阅读 --help；准备可访问且具有使用权的素材。
- 按该型号文档填写 content、时长与分辨率，保留任务 ID，查询到明确终态后下载。
- 核对文件可播放、实际时长与画面，再用任务 ID 或请求时间对齐分组账单。当前没有保存本轮付费成功或失败扣费样本。
- 已有 video-task.json 时运行 python3 seedance-task.py query --state video-task.json；它继续查询原任务，不创建新视频。验收记录至少保留 task_id、model、分组、duration、resolution、generate_audio、status、文件检查与 billed_usd。文本模型 API 报告不覆盖视频质量或视频生成费用。
配置与验证示例
接入包检查模式不发请求；客户端与脚本按各自说明操作。
python3 seedance-task.py --help核验日期与验证范围见各页记录；历史实测保留原日期，示例和空白记录表不等于真实任务结果。