POST
基于已有视频 remix

Authorizations

Authorization
string
header
required

在请求头中传入:Authorization: Bearer sk-...

Path Parameters

video_id
string
required

Body

application/json

视频生成请求。/v1/videos 兼容 OpenAI 风格视频任务;/v1/video/generations 是通用视频任务入口。模型扩展字段会随请求提交,或并入 metadata。

model
string
required

视频模型 ID。不同模型的时长、尺寸、参考图和任务查询方式不同。

Example:

"sora-2"

prompt
string
required

视频生成描述。说明主体、动作、镜头、画面环境、时长感、比例和不能改变的元素。

Example:

"A short cinematic product video"

size
string

视频尺寸或分辨率,例如 1280x720、720x1280。部分模型用 aspect_ratio 或 resolution 表达相同含义。

Example:

"720x1280"

seconds
string

OpenAI 风格视频接口常用的时长字段,传字符串数字,例如 "4"、"6"。

Example:

"4"

duration

通用视频任务常用的时长字段;整数和字符串数字均可提交。

Example:

5

input_reference
file

OpenAI 风格视频接口的图生视频参考文件,在 multipart/form-data 请求中提交。

image
string

单张参考图。可传公网 URL 或 base64,具体以模型说明为准。

images
string[]

多张参考图。可传 URL 或 base64 数组,常见于首尾帧、角色参考或多素材合成。

reference_videos
string[]

参考视频 URL 数组。Seedance 2.0 会按豆包官方 content 结构映射为 role=reference_video 的 video_url;参考视频最多传入 3 个,总时长通常不超过 15 秒,实际限制以官方文档和接口返回为准。

reference_audios
string[]

参考音频 URL 数组。Seedance 2.0 会映射为官方 content 中 role=reference_audio 的 audio_url。

mode
string

生成模式。部分模型有 std、pro 等模式,不同模式的价格和耗时可能不同。

Example:

"std"

metadata
object

模型扩展参数容器,例如 negative_prompt、cfg_scale、camera_control、aspect_ratio、movement_amplitude、bgm、seed 等。

negative_prompt
string

也可放在 metadata 中;顶层传入时会并入 metadata。

Example:

"low quality"

cfg_scale
number

部分视频模型读取;顶层传入时会并入 metadata。

Example:

0.5

camera_control
object

部分视频模型读取;顶层传入时会并入 metadata。

aspect_ratio
string

部分视频模型读取;顶层传入时会并入 metadata。

Example:

"16:9"

Response

任务对象

The response is of type object.