提交视频生成任务

统一视频生成端点（异步任务制）。提交后返回 task_id，通过 /v1/videos/{task_id} 轮询结果。（更新于 2026-02-26）

可用模型（22 个）：

供应商	模型	文生视频	图生视频	说明
快手	`kling-v1`, `kling-v1-6`, `kling-v2-master`, `kling-v2-1-master`, `kling-v2-6`, `kling-v2-5-turbo`, `kling-video-o1`	✅	✅
Vidu	`viduq1`	✅	✅
Vidu	`viduq2`	✅	❌	仅文生视频
Vidu	`viduq3-pro`, `viduq3-turbo`	✅	✅
Vidu	`viduq2-pro`, `viduq2-turbo`	❌	✅	仅图生视频，必须传 `images`
字节跳动	`seedance-1-5-pro-251215`, `seedance-1-0-pro-fast-251015`, `seedance-1-0-pro-250528`	✅	✅
MiniMax	`MiniMax-Hailuo-02`, `MiniMax-Hailuo-2.3`	✅	✅
MiniMax	`MiniMax-Hailuo-2.3-Fast`	❌	✅	仅图生视频，需传 `metadata.first_frame_image`
PixVerse	`pixverse-v3.5`, `pixverse-v4`, `pixverse-v4.5`, `pixverse-v5`, `pixverse-v5.5`, `pixverse-v5.6`	✅	❌	仅文生视频

⚠️ 仅图生视频模型： viduq2-pro、viduq2-turbo、MiniMax-Hailuo-2.3-Fast 不支持纯文本提示，必须提供图片输入，否则上游返回错误。
⚠️ 仅文生视频模型： viduq2、pixverse-* 不支持图片输入，传 images 会被上游拒绝。

图生视频传参方式（因供应商而异）：

Vidu: 顶层 images 数组传图片 URL

Hailuo: metadata.first_frame_image 传图片 URL

PixVerse: metadata.img_id 传已上传的图片 ID（需先上传图片）

快手/字节跳动: 顶层 image 字段传图片 URL

回调通知（可选）: metadata.callback_url（任务状态变化时，供应商回调该地址）

application/json

任务已提交

Body

示例

{
    "id": "task_abc123",
    "task_id": "task_abc123",
    "object": "video",
    "model": "viduq3-pro",
    "status": "",
    "progress": 0,
    "created_at": 1772037755
}

提交视频生成任务

请求参数

请求示例代码

返回响应