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

更新时间：2026-08-13 10:47:55

功能说明

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

调用说明

接口约束

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

请求路径

POST https://ai-api-cn.oceanbase.com/api/v1/videos/generations

请求头

名称	是否必选	示例值	描述
Authorization	是	Bearer YOUR_API_KEY	鉴权信息
Content-Type	否	application/json	请求体格式
X-Async	是	enable	启用异步模式，必须设置为 `enable` 或 `true`。

请求参数

Body 参数

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

返回结果

返回参数

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

data 字段说明

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

请求示例

curl --request POST 'https://ai-api-cn.oceanbase.com/api/v1/videos/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'X-Async: enable' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-260128"
  }'

返回示例

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