创建视频任务

POST

/v1/videos

提交视频生成任务，返回 task_id。支持 multipart/form-data（直接上传文件）与 application/json（传 URL 或 data URI）两种格式。

模式按上传内容自动判断：

仅 prompt → 文生视频（omni-fast）

first_image → 首帧（omni-fast）

first_image + last_image → 首尾帧（omni-fast）

images[]（≤5）→ 参考图（omni-fast）

input_video → 视频转视频（omni-fast-v2v）

素材限制：参考图最多 5 张、每张 ≤5MB；源/参考视频 ≤5MB 且 ≤1920×1080（建议 H.264 MP4、≤720p）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数

application/json

必填

示例

文生视频视频转视频

{
    "model": "omni-fast",
    "prompt": "一只柴犬在樱花树下奔跑，阳光明媚，电影感",
    "aspect_ratio": "16:9",
    "duration": "8"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生视频视频转视频

curl --location '/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--data '{
    "model": "omni-fast",
    "prompt": "一只柴犬在樱花树下奔跑，阳光明媚，电影感",
    "aspect_ratio": "16:9",
    "duration": "8"
}'

返回响应

🟢200

application/json

提交成功，返回 task_id

Bodyapplication/json

示例

{
    "id": "vid-xxxxxx",
    "status": "queued",
    "progress": 0,
    "input_mode": "reference-images"
}

修改于 2026-06-02 08:06:47

图片编辑（nanobanana pro）

轮询任务状态