Skip to main content
POST

请求头

Authorization
string
必填

Bearer API Key,例如 Bearer sk-...。

示例:

"Bearer sk-..."

请求体

application/json

Seedance / 豆包视频异步创建请求(POST /v1/video/generations)。

model
string
必填

视频模型 ID。模型 ID 以模型广场与 Seedance 状态页为准。常用:db-sd2.0-1080p、db-sd2.0-720p、db-sd2.0-480p、db-sd2.0-4k、db-sd2.0-fast-720p、db-sd2.0-fast-480p、db-sd2.0-mini-720p、db-sd2.0-mini-480p、db-sd2.5-1080p、db-sd2.5-720p、db-sd2.5-480p,以及 doubao-seedance-2-0-260128-1080p、doubao-seedance-2-0-260128-720p、doubao-seedance-2-0-fast-260128-720p、doubao-seedance-2-0-fast-260128-480p 等。

示例:

"db-sd2.5-1080p"

prompt
string
必填

视频描述文本。写清主体、场景、镜头运动与风格。也可用 content 中 type=text 提供(与顶层 prompt 二选一)。

示例:

"城市夜景,镜头沿湿润街道缓慢向前,霓虹倒映在路面"

duration
integer

时长(秒),常见 4–15。编辑类任务可用 -1 表示跟随参考视频时长。也可用字符串字段 seconds。

示例:

5

seconds
string

时长(秒)的字符串写法,与 duration 等价;同时存在时以可解析的秒数为准。

示例:

"5"

ratio
enum<string>

画幅比例。也兼容 size、aspect_ratio。

可用选项:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
示例:

"16:9"

size
string

ratio 的别名(如 16:9)。优先使用 ratio。

aspect_ratio
string

ratio 的别名。

images
string[]

参考图 URL 列表(多图参考)。有首/尾帧时不要再混用 images(首尾帧优先,images 会被忽略)。

image
string

单张参考图 URL,等同 images 仅一张。

first_frame

首帧图。可为 URL 字符串,或 URL 数组。别名:start_frame、first_frame_url。

last_frame

尾帧图。可为 URL 字符串,或 URL 数组。别名:end_frame、last_frame_url。

start_frame

first_frame 别名。

end_frame

last_frame 别名。

reference_images
string[]

参考图 URL 列表(与 images 同类,可并用)。

reference_videos
string[]

参考视频 URL 列表(全能参考 / 运镜参考)。别名字段:reference_video_urls、videos。

reference_audios
string[]

参考音频 URL 列表。别名:reference_audio_urls、audios、audio_url。

generate_audio
boolean

是否生成/输出音频轨(音画同步)。也可写在 extra_body.generate_audio。

示例:

true

extra_body
object

扩展字段。常用 generate_audio。

omni_reference_task_type
string

全能参考任务类型(如 edit)。编辑跟随原视频时长时常配合 duration: -1。

示例:

"edit"

content
object[]

多模态 content 数组写法(与顶层 reference_* / images 等价,可选用)。

响应

任务已接受。使用 id 或 task_id 轮询查询接口。

id
string

任务 ID(轮询用)。

task_id
string

任务 ID(与 id 同义)。

object
string
status
string

任务状态。

progress
any

进度(百分比或数值)。

created_at
integer