通用视频生成接口

OpenAI 兼容异步视频接口 /v1/videos。多数视频模型为异步：先提交任务，再轮询结果。

1. 提交视频任务

路径: /v1/videos

请求方式: POST

核心参数说明

参数名	类型	必填	说明
`model`	`string`	是	视频生成模型名称。
`prompt`	`string`	是	描述视频 motion 与画面的提示词文本
`negative_prompt`	`string`	否	负向提示词，用于规避不需要的画面元素，部分模型支持
`images`	`ImageInput`	否	参考底图对象/链接数组（`image_urls` 与 `images` 效果完全相同）。支持 HTTP URL 或 Base64。单张通常作为首帧，双张支持指定首尾帧，三张及以上用于多图参考（可灵/火山等）
`videos`	`VideoInput`	否	参考视频链接数组，用于视频生成视频或视频控制。
`audios`	`AudioInput`	否	参考音频链接数组，用于提供配乐或参考音频。
`resolution`	`string`	否	输出分辨率，取值随`model` 而定，具体将模型支持情况
`ratio`	`string`	否	宽高比（如 `16:9`, `9:16`, `4:3`, `1:1`, `3:4`, `21:9`, `adaptive`等）。Seedance 2.5 在首帧/首尾帧、视频编辑、视频延长三类任务中仅支持 `adaptive`
`duration`	`integer`	否	时长（秒）。Seedance 2.5 为 `4`–`30` 或 `-1`；2.0 为 `4`–`15` 或 `-1`
`generate_audio`	`boolean`	否	是否同步生成匹配的视频背景音效/配音（默认 `false`）
`watermark`	`boolean`	否	是否在生成的视频中添加水印，部分模型支持。
`seed`	`integer`	否	随机数种子（用于控制视频生成的确定性）

ImageInput

字段	类型	必填	说明
`url`	string	是	图片 HttpURL
`role`	string	否	素材角色，见下

可选 role 值：

role	适用场景	说明
`reference_image`	参考图模式	参考图（默认）
`first_frame`	首尾帧模式	首帧
`last_frame`	首尾帧模式	尾帧

VideoInput

字段	类型	必填	说明
`url`	string	是	视频 HttpURL
`role`	string	否	一般为 `reference_video`（默认）

AudioInput

字段	类型	必填	说明
`url`	string	是	音频 URL
`role`	string	否	一般为 `reference_audio`（默认）

Seedance 2.5 的宽高比约束

seedance2.5 在以下三类任务中仅支持 ratio=adaptive（输出宽高比自动跟随输入素材）。这三类任务的拒绝时机不同：

任务类型	触发条件	平台行为
首帧 / 首尾帧生视频	`images[].role` 为 `first_frame` / `last_frame`	创建时同步拒绝，直接返回参数错误（同样要求显式传 `mode=seedance2.5`；只传 `kzep` 时该预检不触发，退化为下面的异步失败路径）
视频编辑	`role` 为 `reference_*`，且提示词含「编辑 / 增加 / 删除 / 修改 / 替换」等意图	放行提交，由模型判定后异步失败，错误码 `InvalidParameter.TaskTypeConstraint`
视频延长	`role` 为 `reference_*`，且提示词含「延长 / 延续 / 续写」等意图	同上

为什么处理方式不同：首帧 / 首尾帧可由 role 确定性判定，平台在创建时即可前置拦截；而视频编辑与视频延长是由模型结合提示词意图判定任务类型的，平台无法在创建时判断，只能放行提交、由模型裁决后异步返回错误。

因此提交这两类任务时，请在创建请求中就把 ratio 设为 adaptive，避免任务跑到一半才失败。

另：视频编辑任务的 duration 仅支持 -1，输出时长自动与输入视频保持一致（误差不超过 0.4 秒）。

提交任务示例

文生视频（最简单）：

首尾帧图生视频：

多模态参考：

响应示例 (获取 Task ID)

{
  "id": "task_abc123xyz789",
  "task_id": "task_abc123xyz789",
  "model": "sd2.5-720p-vip",
  "status": "pending",
  "message": "Task submitted successfully"
}

2. 查询任务状态

查询视频生成任务的状态；任务成功时返回视频 URL。

路径: /v1/videos/{task_id} * 请求方式: GET

通用视频生成接口

1. 提交视频任务#

核心参数说明#

ImageInput#

VideoInput#

AudioInput#

Seedance 2.5 的宽高比约束#

提交任务示例#

响应示例 (获取 Task ID)#

2. 查询任务状态#

请求示例#