创建视频生成任务 - 聚合API接口文档

提交文生视频、单图驱动、首尾帧、多图参考或参考视频生成任务。

输入规则：

不传 image_url、image_urls、video_url 时为文生视频。

veo-3.1-fast-generate-preview 和 veo-3.1-generate-preview：传 1 张 image_url 为单图驱动；传 2 张 image_urls 为首尾帧，第 1 张是首帧，第 2 张是尾帧。

veo-3.1-generate-preview-ref：使用 image_urls 传 1～3 张多参考图；带图时必须同时使用 duration=8 和 aspect_ratio=16:9。不带图时可按普通文生视频使用。

gemini-omni-flash：最多 1 张参考图，或通过 video_url 传 1 个服务端可直接下载的公网 HTTP(S) 视频直链；参考视频不超过 100 MiB，不支持 data URL 或裸 base64。

image_url 和 image_urls 不能同时传。图片字符串支持公网直链、data:image/...;base64,... 和裸 base64；不支持 {"data":"...","mime_type":"..."} 对象形式。

generate_audio、negative_prompt 也兼容 generateAudio、negativePrompt 驼峰写法。

图片的三种传法

{"image_url":"https://example.com/first-frame.jpg"}
{"image_url":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA..."}
{"image_url":"/9j/4AAQSkZJRgABAQAA..."}

Omni 使用 base64 参考图

{"model":"gemini-omni-flash","prompt":"镜头缓缓推进，画面自然微动","duration":4,"aspect_ratio":"16:9","image_urls":["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA..."]}

Omni 参考视频生成

{"model":"gemini-omni-flash","prompt":"保持主体动作节奏，转换为电影感夜景","duration":4,"aspect_ratio":"16:9","video_url":"https://example.com/reference.mp4"}

成功提交只表示进入异步队列，不表示视频已经生成。必须保存响应中的 id，并继续调用查询接口。

请求参数

Header 参数

Body 参数application/json必填

示例

文生视频单图生视频首尾帧生视频（顺序：图1首帧图2尾帧）三图生视频

{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "a paper boat sailing down a rain puddle, cinematic",
    "duration": 4,
    "aspect_ratio": "16:9"
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

任务提交成功。id 是 New API 公开任务 ID，后续查询和取视频都必须使用该值。

Body

示例

{
    "id": "task_FIeVpQgoAo5Dm4bx50ZjOxxjGhZYZjT8",
    "task_id": "task_FIeVpQgoAo5Dm4bx50ZjOxxjGhZYZjT8",
    "object": "video",
    "model": "",
    "status": "queued",
    "progress": 0,
    "created_at": 0
}

🟠400

🟠401

🟠403

🟠413

🟠429

🔴500

🔴502