Seedance 2.0 Mini Reference-to-Video API

bytedance/seedance-2.0-mini/reference-to-video

Seedance 2.0 Mini Reference-to-Video API 根据提示词以及图片、视频和可选音频参考生成 4–15 秒的 480p 或 720p 视频。每次请求最多包含 9 张图片、3 个视频和 3 个音频文件,三类文件合计不超过 12 个,并且至少包含一张图片或一个视频。

输入

提示词
0/20000
参考图片
0/9
参考视频
0/3
参考音频
0/3
参考素材总数0/12
分辨率
时长
画面比例

生成音频

请求模型随视频生成音轨。

高级参数

返回最后一帧

保留视频主结果,并把最后一帧作为额外文件返回。

联网搜索

发送可选的 web_search 布尔字段。

输出

等待运行

生成文件会显示在这里

设置输入、选择时长,然后运行异步视频任务。

5 秒 × 24 积分/秒 = 120 积分 ($0.600)

继续使用

示例

Use Reference Image 1 only for the fictional courier's face, short dark curly hair, cobalt-blue waterproof jacket, charcoal trousers, gray gloves, body proportions, and blue electric cargo tricycle. Use Reference Video 1 only for the start-and-pull-away action, natural weight shift, low side-tracking camera path, wet-road tire spray, and action timing; do not copy its amber-coated rider, red scooter, noodle stall, or night-market layout. Use Reference Audio 1 only for the engine-start cue, rain intensity, tire hiss, and timing; do not add music. Create one continuous four-second shot under the covered flower-market arcade shown by the reference identity: the courier mounts the blue cargo tricycle, starts it, and pulls forward past the flower buckets while preserving the referenced face, clothing, vehicle, roof, and wet-stone setting. No cuts, no extra people, no dialogue, no readable text, no logos, no products, no advertising, no watermark.

Seedance 2.0 Mini 参考生视频 API 概览

Seedance 2.0 Mini Reference-to-Video API 使用 reference_image_urls、reference_video_urls 和 reference_audio_urls 接收参考文件。prompt 需要逐项说明图片、视频或音频用于提供哪些外观、动作、镜头或声音信息。

为什么使用 Seedance 2.0 Mini Reference-to-Video API?

  • 提交最多 9 张参考图片。图片可以提供主体、产品、环境、服装或视觉风格信息。

  • 提交最多 3 个参考视频。视频可以提供主体动作、动作时序和镜头移动信息。

  • 提交最多 3 个参考音频。音频可以提供节奏、环境声、音效或对白信息,但不能单独提交。

  • 在一次请求中组合三类文件。图片、视频和音频可以同时提交,三类文件合计不得超过 12 个。

参数

参数要求说明
prompt必填

trim 后 1–20,000 个字符,并说明每个参考素材的职责。

reference_image_urls条件必填

最多 9 个公开图片 URL;图片或视频至少有一类。

reference_video_urls条件必填

最多 3 个公开视频 URL;每段时长分别向下取整后参与计费。

reference_audio_urls可选

最多 3 个公开音频 URL;不能单独提交。

duration必填

4–15 秒整数;Playground 初始为 5 秒。

resolution可选

API 与 Playground 默认 720p。

默认值720p480p
aspect_ratio可选

Auto 或六种固定比例;Playground 初始为 Auto。

auto16:99:161:121:94:33:4
generate_audio可选

boolean;Playground 初始发送 true。

return_last_frame可选

请求额外最后一帧。

web_search可选

boolean 字段。

seed可选

无公开范围的整数。

使用方法

  1. 给每类素材分配职责说明图片提供哪些外观信息、视频提供哪些动作或镜头信息、音频提供哪些声音信息。

  2. 添加图片或视频参考至少提供一张图片或一个视频,音频单独提交无效。

  3. 核对总数图片 9、视频 3、音频 3,且三类合计最多 12 个。

  4. 在提示词中指明引用关系明确哪个素材负责身份、动作、镜头或声音。

  5. 提交并跟踪运行请求,然后轮询 task_id 或接收终态回调。

价格

没有参考视频时只按输出秒数使用标准费率。存在任一参考视频时,输出秒数与每段参考视频分别 floor 后的秒数之和,全部使用 with-video 费率。

计费项费率说明
480p,无参考视频10 积分 / 输出秒$0.050/秒;5 秒输出为 50 积分。
720p,无参考视频24 积分 / 输出秒$0.120/秒;5 秒输出为 120 积分。
480p,含参考视频6 积分 / 计费秒$0.030 ×(输出秒数 + sum(floor(每段参考视频时长)))。
720p,含参考视频12.5 积分 / 计费秒$0.0625 ×(输出秒数 + sum(floor(每段参考视频时长)))。

适用场景

  • 角色外观与动作参考提交角色图片提供外观信息,并提交动作视频提供运动信息。

  • 产品外观与动作参考提交产品图片提供设计信息,并提交视频提供移动或操作方式。

  • 参考视频中的镜头移动在 prompt 中要求生成视频参考素材的横移、推进、环绕或跟随方式。

  • 音频节奏与声音参考将图片或视频与提供节奏、环境声、音效或对白信息的音频一起提交。

提示词技巧

  • 明确每张图片提供主体外观、服装、环境还是风格信息,不要只写“使用参考图”。
  • 分别说明参考视频提供的主体动作与镜头移动。
  • 音频可以提供节奏、环境声或对白信息,但必须同时提交图片或视频。
  • 只提交与当前生成目标有关的文件,删除内容相互冲突的参考素材。
  • 需要显示精确价格前,先确认每段参考视频的时长已经读取。

注意事项

  • 上限为图片 9、视频 3、音频 3,三类合计 12,而不是 15。
  • 音频不能单独提交,至少需要一张参考图片或一个参考视频。
  • 参考视频按文件分别向下取整,再把全部计费秒数乘同一含视频费率。
  • 参考视频的计费秒数由服务端计算,不属于公开请求输入。
  • 存在未知视频时长时只显示最低价,不伪造精确金额。

Seedance 2.0 Mini Reference-to-Video API — 常见问题

Seedance 2.0 Mini Reference-to-Video API 是什么?

Seedance 2.0 Mini Reference-to-Video API 根据提示词以及图片、视频和可选音频参考生成视频。请求成功后返回 task_id,任务完成后生成文件位于 data.files。

如何调用 Seedance 2.0 Mini Reference-to-Video API?

使用 Bearer Key 向 /api/generate/submit 发送 POST,将模型 ID 设置为 seedance-2.0-mini/reference-to-video,并提供 prompt、duration 以及至少一个公开图片或视频 URL。取得 task_id 后查询任务状态,或提供 callback_url。

Seedance 2.0 Mini Reference-to-Video API 如何计费?

没有参考视频时,480p 每个输出秒使用 10 积分,720p 每个输出秒使用 24 积分。包含参考视频时,480p 每个计费秒使用 6 积分,720p 每个计费秒使用 12.5 积分;计费秒为输出时长加上每个参考视频分别向下取整后的时长。

Seedance 2.0 Mini Reference-to-Video API 支持哪些输入?

每次请求最多包含 9 张图片、3 个视频和 3 个音频文件,三类合计最多 12 个。至少需要一张图片或一个视频,音频不能单独提交。

如何获取 Seedance 2.0 Mini Reference-to-Video API 的生成结果?

仅在状态为 not_started 或 running 时查询任务。状态变为 finished 或 failed 后停止查询,并读取 data.files 中的全部成功文件或 data.error_message。

三种 Seedance 2.0 Mini API 应该如何选择?

需要图片、视频或音频参考时使用 Seedance 2.0 Mini Reference-to-Video API;需要首帧和可选尾帧时使用 Seedance 2.0 Mini Image-to-Video API;没有源素材时使用 Seedance 2.0 Mini Text-to-Video API。