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}:predictLongRunnin

3.请求参数

3.1 Head参数

参数名称 类型 必填 说明 示例值
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。
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
	}
}'
  
  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"
}