Skip to main content
POST
Seedance 2.0 Fast 文生视频

授权

Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>

请求体

application/json
model
enum<string>
必填

您需要调用的模型的 ID (Model ID)

可用选项:
dreamina-seedance-2-0-fast-260128
media
object[]
必填

多模态输入数组。2.0 Fast 支持 textfirst_framelast_framereference_imagereference_videoreference_audio

seconds
enum<string>
默认值:5

生成视频时长,仅支持整数,单位:秒。

  • Seedance 1.0 pro、Seedance 1.0 pro fast: [2, 12] s。
  • Seedance 1.5 pro: [4,12] 或设置为 -1
  • Seedance 2.0 系列: [4,15] 或设置为 -1

注意

Seedance 2.0 系列、Seedance 1.5 pro 支持两种配置方法

  • 指定具体时长:支持有效范围内的任一整数。
  • 智能指定:设置为 -1,表示由模型在有效范围内自主选择合适的视频长度(整数秒)。实际生成视频的时长可通过查询视频生成任务 API 返回的 duration 字段获取。注意视频时长与计费相关,请谨慎设置。
可用选项:
4,
5,
6,
7,
8,
9,
10,
11,
12,
15,
-1
示例:

"5"

size
enum<string>
默认值:720p

Seedance 2.0 系列、Seedance 1.5 pro 默认值:720p Seedance 1.0 pro & pro-fast 默认值:1080p

视频分辨率,枚举值:

  • 480p
  • 720p
  • 1080p:Seedance 2.0 Fast 和 Seedance 2.0 Mini 不支持。
  • 4k:仅 Seedance 2.0 支持
可用选项:
480p,
720p
ratio
enum<string>
默认值:16:9

Seedance 2.0 系列、Seedance 1.5 pro 默认值为 adaptive 其他模型:文生视频默认值 16:9,图生视频默认值 adaptive

生成视频的宽高比例。不同宽高比对应的宽高像素值见下方表格。

  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • 21:9
  • adaptive:根据输入自动选择最合适的宽高比(详见下文说明)

adaptive 适配规则

当配置 ratio 为 adaptive 时,模型会根据生成场景自动适配宽高比;实际生成的视频宽高比可通过查询视频生成任务 API 返回的 ratio 字段获取。

支持模型:

  • Seedance 2.0 系列、Seedance 1.5 Pro 支持
  • 其他模型仅图生视频场景支持

取值规则:

  • 文生视频:根据输入的提示词,智能选择最合适的宽高比。
  • 首帧 / 首尾帧生视频:根据上传的首帧图片比例,自动选择最接近的宽高比。
  • 多模态参考生视频:根据用户提示词意图判断,如果是首帧生视频/编辑视频/延长视频,以该图片/视频为准选择最接近的宽高比;否则,以传入的第一个媒体文件为准(优先级:视频>图片)选择最接近的宽高比。

不同宽高比对应的宽高像素值

注意:图生视频,选择的宽高比与您上传的图片宽高比不一致时,方舟会对您的图片进行裁剪,裁剪时会居中裁剪。

可用选项:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
seed
integer
默认值:-1

Seedance 2.0系列暂不支持

种子整数,用于控制生成内容的随机性。取值范围:[-1, 2^32-1]之间的整数。

注意:

  • 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。
  • 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。
必填范围: -1 <= x <= 4294967295
watermark
boolean
默认值:false

生成视频是否包含水印。

  • false:生成视频不含水印。
  • true:生成视频右下角会展示 AI 生成 水印。
generate_audio
boolean
默认值:true

仅 Seedance 2.0 系列、Seedance 1.5 pro 支持

控制生成的视频是否包含与画面同步的声音。

  • true:模型输出的视频包含同步音频。模型会基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:"你记住,以后不可以用手指指月亮。"
  • false:模型输出的视频为无声视频。

注意:生成的有声视频均为单声道,和传入的音频声道数无关。

return_last_frame
boolean
默认值:false

true:返回生成视频的尾帧图像。设置为 true 后,可通过查询视频生成任务接口获取视频的尾帧图像。尾帧图像的格式为 png,宽高像素值与生成的视频保持一致,无水印。

使用该参数可实现生成多个连续视频:以上一个生成视频的尾帧作为下一个视频任务的首帧,快速生成多个连续视频。

false:不返回生成视频的尾帧图像。

safety_identifier
string

终端用户的唯一标识符,用于协助平台检测您的应用中可能违反火山方舟使用政策的用户。该标识符为英文字符串,需保证对单个用户固定且唯一,长度不超过 64 个字符。推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串,避免泄露用户隐私信息。

响应

提交成功,返回视频任务对象。

id
string

视频生成任务 ID 。仅保存 7 天(从 created at 时间戳开始计算),超时后将自动清除。

  • 设置 "draft": true,为 Draft 视频任务 ID。
  • 设置 "draft": false,为正常视频任务 ID。

创建视频生成任务为异步接口,获取 ID 后,需要通过查询视频生成任务 API 来查询视频生成任务的状态。任务成功后,会输出生成视频的 video_url。