OpenAI 风格视频任务接口
OpenAI Videos 兼容接口。JSON 请求和 multipart/form-data 参考文件上传都从这里进入;额外字段会随请求提交。
请求格式
文生视频通常使用 JSON。图生视频或 remix 需要上传参考文件时使用 multipart/form-data,并传入 input_reference。
参数要点
model、prompt:必填。size:视频尺寸,例如 720x1280、1280x720。seconds:视频时长,OpenAI 风格接口常用字符串数字。input_reference:参考图片或视频文件,multipart 请求中使用。
执行顺序
POST /v1/videos创建任务。- 保存返回的
id或任务 ID。 GET /v1/videos/{video_id}查询状态。- 完成后用
GET /v1/videos/{task_id}/content下载结果。
读取结果
视频生成通常是异步任务。保存任务 ID、创建时间、状态和结果地址,用户刷新页面后也能找回任务结果。
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.