通用视频任务接口
通用视频生成任务接口，创建文生视频、图生视频和带扩展参数的视频任务。
请求格式
使用 application/json。必须包含 model 和 prompt。图生视频使用 image 或 images，具体字段以模型说明为准。
参数要点
duration：生成时长，常见为 5、10 等数字。size/aspect_ratio：分辨率或画面比例。mode：模型模式，例如 std、pro。metadata：模型特有参数，例如镜头控制、负向提示词、运动强度、背景音乐等。
执行顺序
- 调用本接口提交任务。
- 保存返回的任务 ID。
- 用
GET /v1/video/generations/{task_id}查询状态。 - 完成后读取结果 URL，或按返回结构下载文件。
错误定位
- 一直处理中：拉长轮询间隔，并设置超时提示。
- 参数不生效：确认参数应放在顶层还是
metadata。 - 图生视频失败：确认参考图 URL 可访问，或文件字段是否按模型要求上传。
Authorizations
在请求头中传入：Authorization: Bearer sk-...
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.