跳转到主要内容
POST
创建 Seedance 视频生成任务
使用 Authorization: Bearer <API_KEY> 鉴权。任务异步执行,创建成功只返回任务 ID,需调用查询视频生成任务获取结果。

模型

可用的时长、分辨率、比例和计费规则以账号开通情况为准。

content 元素

  • url 可以是素材库中 Status=Active 的素材(asset://<素材ID>),也可以是可公开访问的 HTTP(S) 地址。素材的导入方式见素材库。
  • 提示词中用“图片1”“音频1”“视频1”按同类媒体在 content 中出现的顺序指代参考媒体。
  • 音频不能作为唯一参考媒体,需搭配图片或视频。
  • audio_url 是输入的参考音频,generate_audio 控制输出视频是否带声音,两者独立。使用参考音频或参考视频原声时,generate_audio 传 true。

素材引用错误

引用素材不可用时返回 HTTP 400,error.code 为 InvalidParameter:

错误码

创建请求超时或连接中断时,任务可能已经创建。直接重试可能产生重复任务。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
string
必填

模型 ID。

示例:

"dreamina-seedance-2-0-260128"

content
object[]
必填

文本与参考媒体数组。提示词用“图片1”“音频1”“视频1”按同类素材出现顺序指代参考媒体。

duration
integer

视频时长(秒)。

示例:

5

resolution
string

输出分辨率,例如 720p。

示例:

"720p"

ratio
string

画面比例,例如 16:9、1:1。

示例:

"16:9"

generate_audio
boolean

是否生成声音。使用参考音频或参考视频原声时传 true。

watermark
boolean

是否添加水印。

priority
integer

任务优先级。传入后会在查询结果中回传。

safety_identifier
string

终端用户标识,建议使用不可逆的哈希值。传入后会在查询结果中回传。

响应

任务已创建

id
string
必填

任务 ID。