创建视频生成任务

1. 概述

Google 推出先进的模型，可生成高保真 8 秒 720p、1080p 或 4k 视频，兼具高度逼真的视觉效果与原生音频生成能力。调用创建视频生成任务接口，获取返回的视频任务 name 字段 复制到查询接口查询并下载视频。

模型列表：

• veo-3.0-fast-generate-001

• veo-3.0-generate-001

• veo-3.1-fast-generate-preview

• veo-3.1-generate-preview

2. 请求说明

• 请求方法:POST

• 请求地址:

  https://gateway.theturbo.ai/v1/v1beta/models/{model}:predictLongRunning

---

3. 请求参数

3.1 Header 参数

参数名称	类型	必填	说明	示例值
Content-Type	string	是	设置请求头类型，必须为 application/json	application/json
x-goog-api-key	string	是	身份验证所需的 API_KEY，格式 $YOUR_API_KEY	$YOUR_API_KEY

---

3.2 Body 参数 (application/json)

instances 参数

参数名称	类型	必填	说明	示例（默认值）
prompt	string	是	视频的文字说明。支持音频提示	A lone cowboy rides his horse across an open plain at beautiful sunset, soft light, warm colors
image	Image	否	用于指导视频生成的图片
lastFrame	Image	否	视频最后一帧的图片，用于填充其间的内容
referenceImages	list[referenceImages]	否	一个最多包含三张素材图片或最多一张风格图片的列表
referenceImages.image	Image	否	包含用作主题内容输入的参考图片
referenceImages.referenceType	string	否	指定所提供的参考图片的类型 "asset"：参考图片为生成的视频提供素材，例如：场景、对象或角色。"style"：参考图片为生成的视频提供风格信息，例如：场景颜色、光照或纹理。重要提示：Veo 3.1 模型不支持 referenceImages.style。如要使用风格图片，请使用 veo-2.0-generate-exp。

parameters 参数

参数名称	类型	必填	说明	示例（默认值）
durationSeconds	int	否	输出视频的时长。 4，6，8。	8
aspectRatio	string	否	视频的宽高比。16:9 9:16	16:9
resolution	string	否	视频的宽高 720p 1080p 4k	720p
negativePrompt	string	否	描述视频中不应包含的内容

---

4. 请求示例

不携带参考图像

curl https://gateway.theturbo.ai/v1/v1beta/models/veo-3.0-fast-generate-001:predictLongRunning \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $YOUR_API_KEY" \
-d '{
	"instances": [
		{
			"prompt": "A lone cowboy rides his horse across an open plain at beautiful sunset, soft light, warm colors"
		}
	],
	"parameters": {
		"durationSeconds": 4
	}
}'

携带参考图像

5. 响应示例

{
  "name": "models/veo-3.0-fast-generate-001/operations/70f9e088-ab9a-4329-af7e-8df5862c46dd"
}