Create Video Generation - 创建视频生成任务

更新时间：2026-06-16 17:57:45

功能说明

文生视频接口，仅支持异步模式。调用该接口后，将根据输入的文本描述生成视频任务，并返回任务ID。您需要通过 /api/v1/tasks/{task_id} 接口查询任务执行结果。

调用说明

接口约束

调用者需要拥有 API Key，详情请参见管理 AI API Key。

请求路径

POST {BASE_URL}/api/v1/videos/generations

请求头

名称	是否必选	示例值	描述
Authorization	是	Bearer {token}	鉴权信息
Content-Type	否	application/json	请求体格式
X-Async	否	enable	可省略；如显式设置，仅支持 `enable` 或 `true`。省略时默认异步。

请求参数

Body 参数

名称	类型	是否必填	示例值	描述
model	string	是	video-gen-model-v1	模型名称，支持以下模型： - 火山引擎视频生成模型（如 `doubao-video-v1`） - 百炼视频生成模型（如 `wanx-video-v1`）具体模型列表请参考对应厂商文档：火山引擎、百炼

返回结果

返回参数

名称	类型	描述
success	boolean	请求是否成功
code	string	返回码
message	string	返回信息
data	object	业务返回数据

data 字段说明

名称	类型	描述
task_id	string	生成的视频任务ID，用于后续查询任务状态和结果

请求示例

curl --request POST '{BASE_URL}/api/v1/videos/generations' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "video-gen-model-v1"
  }'

返回示例

{
  "success": true,
  "code": "200",
  "message": "successful",
  "data": {
    "task_id": "task-1234567890abcdef"
  }
}