Skip to main content
POST
国内用户请注意: 中国大陆用户请使用 https://toapis.cn 作为接口地址(Base URL)。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。
样片模式把一次生成拆成两个阶段:先按较低成本生成 480p 样片,确认运镜和画面后,再用该样片生成 1080p 成稿。成稿由上游复用样片的提示词和素材,因此第二阶段不需要重复提交这些内容。 两个阶段都调用 POST /v1/videos/generations,并使用同一个 seedance-2-5 模型。

两阶段流程

  1. 提交样片请求,带上 draft: true,从响应中拿到样片任务 ID。
  2. 等待样片完成,通过获取视频任务状态确认 status 为 completed。
  3. 提交成稿请求,带上 draft_task_id 并填入第 1 步的样片任务 ID,不要重复传提示词或素材。

阶段对照

成稿必须与样片使用相同的 model,且样片所在渠道的样片能力仍然可用。样片任务未成功完成、创建已超过 7 天、模型不一致或渠道能力已关闭时,成稿会以 invalid_draft_task 失败,需要重新生成样片。

Body

boolean
默认值:false
设为 true 提交样片请求。样片按 480p 生成,其余参数与普通生成一致。仅支持 seedance-2-5;用于其他模型时返回 draft mode is only supported for Seedance 2.5。
string
成稿请求必填,填入样片请求返回的任务 ID(tsk_vid_...)。不能与 draft: true 同时使用。传入 draft_task_id 后不得再传 prompt、image_urls、image_with_roles、video_with_roles 或 audio_with_roles,否则返回 draft requests cannot include prompt or media。
string
样片固定 480p,成稿固定 1080p。可以省略,省略时按对应阶段的固定值生成;显式传入其他值会被拒绝。
string
默认值:"mp4"
仅成稿请求可指定,支持 mp4 和 mov。
boolean
默认值:false
成稿不会自动继承样片的尾帧设置。成稿也需要返回尾帧时,请在成稿请求中重新传入 true。
prompt、duration、aspect_ratio、generate_audio、参考素材等其余参数在样片阶段的使用方式与普通生成一致,详见Seedance 2.5 视频生成。

请求示例

下面两个示例分别是提交样片和用样片生成成稿的完整请求,可以依次执行。

计费

样片和成稿分别计费,各自在任务完成时结算。样片按样片价结算;成稿把样片视频作为视频输入,按含视频输入的费率结算,因此单价高于样片。实际扣费以任务结果和价格与实际费用为准。