Skip to main content
POST

授权

​
Authorization
string
header
必填

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

请求体

application/json
​
model
enum<string>
必填

您需要调用的模型的 ID （Model ID）

可用选项:
seedance-1-5-pro-251215,
seedance-1-0-pro-250528,
seedance-1-0-pro-fast-251015,
dreamina-seedance-2-0-260128,
dreamina-seedance-2-0-fast-260128,
dreamina-seedance-2-0-mini-260615,
dreamina-seedance-2-5-260628
​
content
(文本信息 · object | 图片信息 · object | 视频信息 · object | 音频信息 · object | 样片信息 · object)[]
必填

输入给模型，生成视频的信息，支持文本、图片、音频、视频、样片任务 ID。

注意：Seedance 2.5 系列、Seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图/视频。为了便利创作者对肖像的使用，平台推出了以下解决方案。

  • 支持使用部分模型的含人脸原始产物作为输入素材
  • 支持使用预置虚拟人像作为输入素材
  • 支持使用已授权真人素材作为输入

支持以下几种组合：

  • 文本
  • 文本（可选）+ 图片
  • 文本（可选）+ 视频
  • 文本（可选）+ 音频（仅 Seedance 2.5 系列支持单独输入音频）
  • 文本（可选）+ 图片 + 音频
  • 文本（可选）+ 图片 + 视频
  • 文本（可选）+ 视频 + 音频
  • 文本（可选）+ 图片 + 视频 + 音频
  • 样片任务 ID：样片指使用 Seedance 模型成功生成的样片视频，模型可基于样片生成高质量正式视频。

输入给模型的提示词信息。

​
callback_url
string

填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，方舟将向此地址推送 POST 请求。

回调请求内容结构与查询任务API的返回体一致。

回调返回的 status 包括以下状态：

  • queued：排队中。
  • running：任务运行中。
  • succeeded：任务成功。（如发送失败，即5秒内没有接收到成功发送的信息，回调三次）
  • failed：任务失败。（如发送失败，即5秒内没有接收到成功发送的信息，回调三次）
  • expired：任务超时，即任务处于运行中或排队中状态超过过期时间。可通过 execution_expires_after 字段设置过期时间。
​
return_last_frame
boolean
默认值:false

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

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

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

​
service_tier
enum<string>
默认值:default

不支持修改已提交任务的服务等级 Seedance 2.5 系列、Seedance 2.0 系列仅支持在线推理模式，不支持配置该参数 目前我们还未接入离线推理

指定处理本次请求的服务等级类型，枚举值：

  • default：在线推理模式，RPM 和并发数配额较低，适合对推理时效性要求较高的场景。
  • flex：离线推理模式，TPD 配额更高，价格为在线推理的 50%，适合对推理时延要求不高的场景。
可用选项:
default,
flex
​
execution_expires_after
integer
默认值:172800

任务超时阈值。指定任务提交后的过期时间（单位：秒），从 created at 时间戳开始计算。默认值 172800 秒，即 48 小时。取值范围：[3600，259200]。

不论使用哪种 service_tier，都建议根据业务场景设置合适的超时时间。超过该时间后任务会被自动终止，并标记为 expired 状态。

必填范围: 3600 <= x <= 259200
​
generate_audio
boolean
默认值:true

仅 Seedance 2.5、Seedance 2.0 系列、Seedance 1.5 pro 支持

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

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

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

​
draft
boolean
默认值:false

仅 Seedance 1.5 pro 支持

控制是否开启样片模式。

  • true：开启样片模式，生成一段预览视频，快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期。消耗 token 数较正常视频更少，使用成本更低。
  • false：关闭样片模式，正常生成一段视频。

说明：开启样片模式后，将使用 480p 分辨率生成 Draft 视频（使用其他分辨率会报错），不支持返回尾帧功能，不支持离线推理功能。

​
tools
object[]

仅 Seedance 2.5 系列、Seedance 2.0 系列支持

配置模型要调用的工具。(海外节点目前不支持web_search)

​
safety_identifier
string

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

Maximum string length: 64
​
priority
integer
默认值:0

仅 Seedance 2.5 系列、Seedance 2.0 系列支持。(每个用户可使用的最高priority请联系销售获取)

设置当前请求的执行优先级，决定其在队列中的排序位置。取值范围：0~9，数值越大，优先级越高。

默认情况下，请求按 FIFO（First In, First Out，先进先出）顺序执行。设置较高优先级后，该请求将插队到同 Endpoint（推理接入点）下所有低优先级请求之前。

说明：

  • 相同优先级的请求之间仍按 FIFO 排序。
  • 优先级仅影响排队顺序，不会中断正在执行中（status=running）的任务。
  • 优先级仅在同一 Endpoint 内生效，不影响其他 Endpoint。
  • 离线推理模式（service_tier=flex）不支持配置优先级。

示例：

某 Endpoint 当前队列中有 3 个排队中（status=queued）任务，优先级均为 0（默认）。

队列：[任务A: priority=0] → [任务B: priority=0] → [任务C: priority=0]

此时提交一个 priority=5 的新请求，该请求将直接排到队首：

队列：[新请求: priority=5] → [任务A: priority=0] → [任务B: priority=0] → [任务C: priority=0]

必填范围: 0 <= x <= 9
​
resolution
enum<string>
默认值:720p

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

视频分辨率，枚举值：

  • 480p：Seedance 2.5 系列、Seedance 2.0 系列、Seedance 1.5 pro、Seedance 1.0 pro & pro-fast 均支持。
  • 720p：所有模型均支持。
  • 1080p：Seedance 2.0 Fast、Seedance 2.0 Mini 不支持。
  • 4k：仅 Seedance 2.0 支持。
可用选项:
480p,
720p,
1080p,
4k
​
ratio
enum<string>
默认值:adaptive

Seedance 2.5 系列、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.5 系列、Seedance 2.0 系列、Seedance 1.5 Pro 支持
  • 其他模型仅图生视频场景支持

取值规则：

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

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

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

可用选项:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
​
output_format
enum<string>
默认值:mp4

输出视频的格式。

  • mp4：通用格式，兼容性最好，采用标准色彩精度，可在网页、移动端、各类播放器及分发平台直接播放。
  • mov：面向专业场景的高色彩精度格式，更好地保持画面色彩与亮度一致性、适用于调色、抠像、合成等对色彩还原要求高的专业后期加工。推荐在视频编辑、视频延长场景使用 mov 格式作为输入和输出。

mov 格式播放兼容性

mov 格式采用专业编码（H.264 视频编码 + yuv444p 色度采样 + PCM 音频编码），部分播放器可能不兼容。以下为常见的支持播放 mov 格式的播放器：

模型支持： Seedance 2.5

可用选项:
mp4,
mov
​
duration
integer
默认值: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.5 系列: [2,30] 或设置为 -1

注意

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

  • 指定具体时长：支持有效范围内的任一整数。
  • 智能指定：设置为 -1，表示由模型在有效范围内自主选择合适的视频长度（整数秒）。实际生成视频的时长可通过查询视频生成任务 API 返回的 duration 字段获取。注意视频时长与计费相关，请谨慎设置。
必填范围: -1 <= x <= 30
​
frames
integer

Seedance 2.5 系列、Seedance 2.0 系列、Seedance 1.5 pro 暂不支持 duration 和 frames 二选一即可，frames 的优先级高于 duration。如果您希望生成小数秒的视频，建议指定 frames。

生成视频的帧数。通过指定帧数，可以灵活控制生成视频的长度，生成小数秒的视频。

由于 frames 的取值限制，仅能支持有限小数秒，您需要根据公式推算最接近的帧数。

  • 计算公式：帧数 = 时长 × 帧率（24）。
  • 取值范围：支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值，其中 n 为正整数。

例如：假设需要生成 2.4 秒的视频，帧数=2.4×24=57.6。由于 frames 不支持 57.6，此时您只能选择一个最接近的值。根据 25+4n 计算出最接近的帧数为 57，实际生成的视频为 57/24=2.375 秒。

必填范围: 29 <= x <= 289
​
camera_fixed
boolean
默认值:false

参考图场景不支持，Seedance 2.5 系列、Seedance 2.0 系列 暂不支持

是否固定摄像头。

  • true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。
  • false：不固定摄像头。
​
watermark
boolean
默认值:false

生成视频是否包含水印。

  • false：生成视频不含水印。
  • true：生成视频右下角会展示 AI 生成 水印。
​
omni_reference_task_type
enum<string>
默认值:auto

仅 Seedance 2.5 系列支持

任务类型引导

Seedance 2.5 全模态参考生视频任务 包括参考生视频、视频编辑和视频延长 3 类子任务。不同任务类型对参数有特殊限制，为减少任务创建后异步报错的情况，可通过本参数指定子任务类型，以提前校验对应限制。

  • 默认情况下，即 omni_reference_task_type=auto：模型根据输入素材和提示词自动判定任务类型，再校验参数取值。如果参数与实际任务类型不兼容，任务将触发异步报错（错误码：InvalidParameter.TaskTypeMismatch）。

  • 显式指定任务类型，即 omni_reference_task_type 为 reference、edit 或 extend：接口在提交任务时提前校验对应任务的特殊参数限制。不符合要求时，接口立即报错，任务不会创建。

注意

实际处理任务时，模型仍会进一步结合提示词判断任务类型。若实际判定的任务类型和指定的不一致，仍会触发异步报错（错误码：InvalidParameter.TaskTypeMismatch）。建议遵循各任务类型的提示词写法，降低报错概率。

可选值：

  • auto：由模型根据输入素材和提示词自动判定任务类型。
  • reference：参考生视频任务，即基于参考图片、参考视频或参考音频生成新视频。设置 reference 时，ratio 或 duration 无特殊限制。
  • edit：视频编辑任务，即对原视频的画面或音频进行编辑操作。设置 edit 时，content 中必须至少包含一个 reference_video，且视频时长必须为 4–30 秒；ratio 必须为 adaptive；duration 必须为 -1。
  • extend：视频延长任务，即对原视频向前或向后延长。设置 extend 时，content 中必须至少包含一个 reference_video；ratio 必须为 adaptive。

模型支持：

  • Seedance 2.5
可用选项:
auto,
reference,
edit,
extend

响应

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

​
id
string

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

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

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