基于已有视频 remix
基于已生成的视频继续调整风格、节奏、镜头或画面表现。
请求格式
路径中的 {video_id} 使用原视频任务 ID。请求体继续传 model、prompt、seconds 等视频参数。
使用条件
- 对已生成结果做小幅调整。
- 在同一主题下尝试不同光线、节奏或镜头语言。
- 保留原视频方向,同时生成新的候选版本。
读取结果
接口会创建新的任务对象。保存新任务 ID,并继续用视频查询接口获取状态和结果。
Authorizations
在请求头中传入:Authorization: Bearer sk-...
Path Parameters
Body
视频生成请求。/v1/videos 兼容 OpenAI 风格视频任务;/v1/video/generations 是通用视频任务入口。模型扩展字段会随请求提交,或并入 metadata。
视频模型 ID。不同模型的时长、尺寸、参考图和任务查询方式不同。
"sora-2"
视频生成描述。说明主体、动作、镜头、画面环境、时长感、比例和不能改变的元素。
"A short cinematic product video"
视频尺寸或分辨率,例如 1280x720、720x1280。部分模型用 aspect_ratio 或 resolution 表达相同含义。
"720x1280"
OpenAI 风格视频接口常用的时长字段,传字符串数字,例如 "4"、"6"。
"4"
通用视频任务常用的时长字段;整数和字符串数字均可提交。
5
OpenAI 风格视频接口的图生视频参考文件,在 multipart/form-data 请求中提交。
单张参考图。可传公网 URL 或 base64,具体以模型说明为准。
多张参考图。可传 URL 或 base64 数组,常见于首尾帧、角色参考或多素材合成。
参考视频 URL 数组。Seedance 2.0 会按豆包官方 content 结构映射为 role=reference_video 的 video_url;参考视频最多传入 3 个,总时长通常不超过 15 秒,实际限制以官方文档和接口返回为准。
参考音频 URL 数组。Seedance 2.0 会映射为官方 content 中 role=reference_audio 的 audio_url。
生成模式。部分模型有 std、pro 等模式,不同模式的价格和耗时可能不同。
"std"
模型扩展参数容器,例如 negative_prompt、cfg_scale、camera_control、aspect_ratio、movement_amplitude、bgm、seed 等。
也可放在 metadata 中;顶层传入时会并入 metadata。
"low quality"
部分视频模型读取;顶层传入时会并入 metadata。
0.5
部分视频模型读取;顶层传入时会并入 metadata。
部分视频模型读取;顶层传入时会并入 metadata。
"16:9"
Response
任务对象
The response is of type object.