此页面由 Cloud Translation API 翻译。

Veo | AI 视频生成器

您可以使用 Veo on Vertex AI，根据您在 Google Cloud 控制台中提供或在请求中发送给 Vertex AI API 的文本提示或图片提示生成新视频。

在 Vertex AI Media Studio 中试用 Veo

在 Colab 中试用 Veo

申请访问权限：高级功能和 Veo 等待名单

模型版本

您可以使用多种视频生成模型。如需了解详情，请参阅 Veo 模型。

位置

位置是您可以在请求中指定的区域，用于控制静态数据的存储位置。如需查看可用区域的列表，请参阅 Vertex AI 上的生成式 AI 位置。

Responsible AI

Veo 可根据自然语言文本提示和图片提示生成逼真且高质量的视频，包括所有年龄段的人物图片。根据文本或图片提示的上下文，Veo 可能会显示一条错误消息，指示您的Google Cloud 项目需要获得人物或儿童内容生成的批准。

如果您需要获得批准，请与您的 Google 客户代表联系。

准备工作

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Enable the Vertex AI API.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Enable the Vertex AI API.

Enable the API

为您的环境设置身份验证。

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 gcloud CLI 的凭据。

After installing the Google Cloud CLI, initialize it by running the following command:

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

根据文本生成视频

您可以仅使用描述性文本作为输入来生成新视频。以下示例展示了生成视频的基本说明。

控制台

在 Google Cloud 控制台中，前往 Vertex AI Studio > Media Studio 页面。

Media Studio
点击视频。
可选：在设置窗格中，配置以下设置：
- 模型：从可用选项中选择一个模型。
- 宽高比：选择 16:9 或 9:16。
  
  注意： veo-3.0-generate-preview 不支持 9:16 的宽高比。
- 结果数量：调整滑块或输入介于 1 和 4 之间的值。
- 视频时长：选择介于 5 秒和 8 秒之间的时长。
- 输出目录：点击浏览以创建或选择一个 Cloud Storage 存储桶来存储输出文件。
可选：在安全部分，选择以下人物生成设置之一：
- 允许（仅限成人）：默认值。仅生成成人人物或人脸。请勿生成青少年或儿童人物或人脸。
- 不允许：不生成人物或人脸。
可选：在高级选项部分中，输入用于随机生成视频的种子值。
在编写提示框中，输入描述要生成的视频的文字提示。
点击生成。

REST

设置您的环境后，您可以使用 REST 测试文本提示。以下示例会向发布方模型端点发送请求。

如需详细了解 Veo API，请参阅 Veo on Vertex AI API。

使用以下命令发送视频生成请求。此请求会启动长时间运行的操作，并将输出存储到您指定的 Cloud Storage 存储桶。

在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- MODEL_ID：要使用的模型 ID。可用的值：
  - veo-2.0-generate-001（正式版）
  - veo-3.0-generate-preview（预览版）
- TEXT_PROMPT：用于指导视频生成的文本提示。
- OUTPUT_STORAGE_URI：可选：用于存储输出视频的 Cloud Storage 存储桶。如果未提供，则回答中会返回视频字节。例如：gs://video-bucket/output/
- RESPONSE_COUNT：您要生成的视频文件数量。接受的整数值：1-4。
- DURATION：您要生成的视频文件的时长。接受的整数值是 5-8。
- 其他可选参数
  
  根据您的应用场景，使用以下可选变量。在 "parameters": {} 对象中添加以下部分或全部参数。
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO：字符串。可选。定义所生成视频的宽高比。值：16:9（默认，横向）或 9:16（纵向）。
  - NEGATIVE_PROMPT：字符串。可选。用于描述您想要阻止模型生成的内容的文本字符串。
  - PERSON_SAFETY_SETTING：字符串。可选。用于控制是否允许人物或人脸生成的安全设置。值：
    - allow_adult（默认值）：仅允许生成成年人。
    - disallow：禁止在图片中包含人物或人脸。
  - RESPONSE_COUNT：int。可选。请求的输出图片数量。值：1-4。
  - SEED_NUMBER：uint32。可选。用于使生成的视频具有确定性的数字。通过在请求中指定种子编号而无需更改其他参数，可引导模型生成相同的视频。值：0 - 4294967295。
HTTP 方法和网址：
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
请求 JSON 正文：
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT"
  }
}
```
如需发送请求，请选择以下方式之一：
curl

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
此请求会返回包含唯一操作 ID 的完整操作名称。使用此完整操作名称轮询视频生成请求的状态。
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```

可选：检查视频生成长时间运行操作的状态。

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：您的 Google Cloud 项目 ID。
MODEL_ID：要使用的模型 ID。可用的值：
- veo-2.0-generate-001（正式版）
- veo-3.0-generate-preview（预览版）
OPERATION_ID：在原始生成视频请求中返回的唯一操作 ID。

HTTP 方法和网址：

POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation

请求 JSON 正文：

{
  "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID"
}

如需发送请求，请选择以下方式之一：

curl

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation"

PowerShell

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation" | Select-Object -Expand Content

此请求会返回有关操作的信息，包括操作是否仍在运行或已完成。

响应

{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/cloud.ai.large_models.vision.GenerateVideoResponse",
    "videos": [
      {
        "gcsUri":"gs://BUCKET_NAME/TIMESTAMPED_FOLDER/sample_0.mp4",
        "mimeType": "video/mp4"
      }
    ]
  }
}

Gen AI SDK for Python

安装

pip install --upgrade google-genai

如需了解详情，请参阅 SDK 参考文档。

设置环境变量以将 Gen AI SDK 与 Vertex AI 搭配使用：

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True

import time
from google import genai
from google.genai.types import GenerateVideosConfig

client = genai.Client()

# TODO(developer): Update and un-comment below line
# output_gcs_uri = "gs://your-bucket/your-prefix"

operation = client.models.generate_videos(
    model="veo-3.0-generate-preview",
    prompt="a cat reading a book",
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        output_gcs_uri=output_gcs_uri,
    ),
)

while not operation.done:
    time.sleep(15)
    operation = client.operations.get(operation)
    print(operation)

if operation.response:
    print(operation.result.generated_videos[0].video.uri)

# Example response:
# gs://your-bucket/your-prefix

根据图片生成视频

示例输入	示例输出
输入图片¹ 文本提示：大象自然地四处走动

¹ 通过 Imagen on Vertex AI 根据以下提示生成的图片：一只钩针编织的大象，图案错综复杂，正在稀树草原上行走

您可以仅使用图片作为输入来生成新视频，也可以使用图片和描述性文本作为输入。以下示例展示了如何通过图片和文本生成视频的基本说明。

控制台

在 Google Cloud 控制台中，前往 Vertex AI Studio > Media Studio 页面。

Media Studio
点击视频。
可选：在设置窗格中，配置以下设置：
- 模型：从可用选项中选择一个模型。
- 宽高比：选择 16:9 或 9:16。
  
  注意： veo-3.0-generate-preview 不支持 9:16 的宽高比。
- 结果数量：调整滑块或输入介于 1 和 4 之间的值。
- 视频时长：选择介于 5 秒和 8 秒之间的时长。
- 输出目录：点击浏览以创建或选择一个 Cloud Storage 存储桶来存储输出文件。
可选：在安全部分，选择以下人物生成设置之一：
- 允许（仅限成人）：默认值。仅生成成人人物或人脸。请勿生成青少年或儿童人物或人脸。
- 不允许：不生成人物或人脸。
可选：在高级选项部分中，输入用于随机生成视频的种子值。
在撰写提示框中，点击上传。
选择要上传的本地图片，然后点击选择。
在编写提示框中，输入描述要生成的视频的文字提示。
点击生成。

REST

设置您的环境后，您可以使用 REST 测试文本提示。以下示例会向发布方模型端点发送请求。

如需详细了解 Veo API，请参阅 Veo on Vertex AI API。

使用以下命令发送视频生成请求。此请求会启动长时间运行的操作，并将输出存储到您指定的 Cloud Storage 存储桶。

在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- MODEL_ID：要使用的模型 ID。可用的值：
  - veo-2.0-generate-001（正式版）
  - veo-3.0-generate-preview（预览版）
- TEXT_PROMPT：用于指导视频生成的文本提示。
- INPUT_IMAGE：表示输入图片的 base64 编码字节串。为确保质量，输入图片应为 720p 或更高（1280 x 720 像素），宽高比应为 16:9 或 9:16。其他宽高比或尺寸的图片可能会在上传过程中调整大小或进行中心剪裁。
- MIME_TYPE：输入图片的 MIME 类型。仅支持以下 MIME 类型的图片：image/jpeg 或 image/png。
- OUTPUT_STORAGE_URI：可选：用于存储输出视频的 Cloud Storage 存储桶。如果未提供，则回答中会返回视频字节。例如：gs://video-bucket/output/
- RESPONSE_COUNT：您要生成的视频文件数量。接受的整数值：1-4。
- DURATION：您要生成的视频文件的时长。接受的整数值是 5-8。
- 其他可选参数
  
  根据您的应用场景，使用以下可选变量。在 "parameters": {} 对象中添加以下部分或全部参数。
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO：字符串。可选。定义所生成视频的宽高比。值：16:9（默认，横向）或 9:16（纵向）。
  - NEGATIVE_PROMPT：字符串。可选。用于描述您想要阻止模型生成的内容的文本字符串。
  - PERSON_SAFETY_SETTING：字符串。可选。用于控制是否允许人物或人脸生成的安全设置。值：
    - allow_adult（默认值）：仅允许生成成年人。
    - disallow：禁止在图片中包含人物或人脸。
  - RESPONSE_COUNT：int。可选。请求的输出图片数量。值：1-4。
  - SEED_NUMBER：uint32。可选。用于使生成的视频具有确定性的数字。通过在请求中指定种子编号而无需更改其他参数，可引导模型生成相同的视频。值：0 - 4294967295。
HTTP 方法和网址：
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
请求 JSON 正文：
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT",
      "image": {
        "bytesBase64Encoded": "INPUT_IMAGE",
        "mimeType": "MIME_TYPE"
      }
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": RESPONSE_COUNT
  }
}
```
如需发送请求，请选择以下方式之一：
curl

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
此请求会返回包含唯一操作 ID 的完整操作名称。使用此完整操作名称轮询视频生成请求的状态。
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```
可选：检查视频生成长时间运行操作的状态。

在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- MODEL_ID：要使用的模型 ID。可用的值：
  - veo-2.0-generate-001
- TEXT_PROMPT：用于指导视频生成的文本提示。
- OUTPUT_STORAGE_URI：可选：用于存储输出视频的 Cloud Storage 存储桶。如果未提供，则回答中会返回视频字节。例如：gs://video-bucket/output/
- RESPONSE_COUNT：您要生成的视频文件数量。接受的整数值：1-4。
- 其他可选参数
  
  根据您的应用场景，使用以下可选变量。在 "parameters": {} 对象中添加以下部分或全部参数。
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO：字符串。可选。定义所生成视频的宽高比。值：16:9（默认，横向）或 9:16（纵向）。
  - NEGATIVE_PROMPT：字符串。可选。用于描述您想要阻止模型生成的内容的文本字符串。
  - PERSON_SAFETY_SETTING：字符串。可选。用于控制是否允许人物或人脸生成的安全设置。值：
    - allow_adult（默认值）：仅允许生成成年人。
    - disallow：禁止在图片中包含人物或人脸。
  - RESPONSE_COUNT：int。可选。请求的输出图片数量。值：1-4。
  - SEED_NUMBER：uint32。可选。用于使生成的视频具有确定性的数字。通过在请求中指定种子编号而无需更改其他参数，可引导模型生成相同的视频。值：0 - 4294967295。
HTTP 方法和网址：
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
请求 JSON 正文：
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT"
  }
}
```
如需发送请求，请选择以下方式之一：
curl

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
此请求会返回包含唯一操作 ID 的完整操作名称。使用此完整操作名称轮询视频生成请求的状态。
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```

Gen AI SDK for Python

安装

pip install --upgrade google-genai

如需了解详情，请参阅 SDK 参考文档。

设置环境变量以将 Gen AI SDK 与 Vertex AI 搭配使用：

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True

import time
from google import genai
from google.genai.types import GenerateVideosConfig, Image

client = genai.Client()

# TODO(developer): Update and un-comment below line
# output_gcs_uri = "gs://your-bucket/your-prefix"

operation = client.models.generate_videos(
    model="veo-3.0-generate-preview",
    image=Image(
        gcs_uri="gs://cloud-samples-data/generative-ai/image/flowers.png",
        mime_type="image/png",
    ),
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        output_gcs_uri=output_gcs_uri,
    ),
)

while not operation.done:
    time.sleep(15)
    operation = client.operations.get(operation)
    print(operation)

if operation.response:
    print(operation.result.generated_videos[0].video.uri)

# Example response:
# gs://your-bucket/your-prefix

提示重写器

Veo 提供基于 LLM 的提示增强工具，也称为提示重写器。提示重写器可让您选择重写提示，以便在提示中添加视频说明、镜头运动、转写和音效。提示越详细，生成的视频质量就越高。

如果您停用提示增强功能，视频质量以及输出内容与您提供的提示的相似程度可能会受到影响。对于以下型号版本，此功能默认处于启用状态：

veo-2.0-generate-001
veo-3.0-generate-preview（预览版）

重要提示：使用 veo-3.0-generate-preview 时，您无法停用提示重写器

仅当原始提示的长度少于 30 个字词时，API 响应才会传送重写的提示。

如需关闭提示增强功能，请执行以下操作：

控制台

在 Google Cloud 控制台中，前往 Vertex AI Studio > Media Studio 页面。

前往媒体工作室
点击 Veo。
在设置中，点击启用提示增强功能切换开关。
在写下您的提示框中，输入提示，然后点击生成

REST

如需详细了解 Veo API，请参阅 Veo on Vertex AI API。

使用以下命令发送视频生成请求。此请求会启动长时间运行的操作，并将输出存储到您指定的 Cloud Storage 存储桶。

在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- MODEL_ID：要使用的模型 ID。可用的值：
  - veo-2.0-generate-001（GA 许可名单）
  - veo-3.0-generate-preview（预览版）
- TEXT_PROMPT：用于指导视频生成的文本提示。
- OUTPUT_STORAGE_URI：可选：用于存储输出视频的 Cloud Storage 存储桶。如果未提供，则回答中会返回视频字节。例如：gs://video-bucket/output/。
- RESPONSE_COUNT：您要生成的视频文件数量。接受的整数值：1-4。
- DURATION：您要生成的视频文件的时长。接受的整数值为 5-8。
- ENHANCED_PROMPT：是否使用增强型提示。您可以使用以下任一方式：
  - True：（默认）使用 Gemini 增强提示。
  - False：不使用 Gemini 来优化提示。
- 其他可选参数
  
  根据您的应用场景，使用以下可选变量。在 "parameters": {} 对象中添加以下部分或全部参数。
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO：字符串。可选。定义所生成视频的宽高比。值：16:9（默认，横向）或 9:16（纵向）。
  - NEGATIVE_PROMPT：字符串。可选。用于描述您想要阻止模型生成的内容的文本字符串。
  - PERSON_SAFETY_SETTING：字符串。可选。用于控制是否允许人物或人脸生成的安全设置。值：
    - allow_adult（默认值）：仅允许生成成年人。
    - disallow：禁止在图片中包含人物或人脸。
  - RESPONSE_COUNT：int。可选。请求的输出图片数量。值：1-4。
  - SEED_NUMBER：uint32。可选。用于使生成的视频具有确定性的数字。通过在请求中指定种子编号而无需更改其他参数，可引导模型生成相同的视频。值：0 - 4294967295。
HTTP 方法和网址：
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
请求 JSON 正文：
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT",
    "durationSeconds": "DURATION",
    "enhancePrompt": ENHANCED_PROMPT
  }
}
```
如需发送请求，请选择以下方式之一：
curl

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
此请求会返回包含唯一操作 ID 的完整操作名称。使用此完整操作名称轮询视频生成请求的状态。
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```

后续步骤

阅读 Google DeepMind 关于 Veo 模型的信息。
阅读博文“Veo 和 Imagen 3：正式推出 Vertex AI 上的新视频和图片生成模型”。
阅读博文“与创作者一起为创作者打造的全新生成式媒体模型和工具”。

Veo | AI 视频生成器 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

模型版本

位置

Responsible AI

准备工作

Console

REST

根据文本生成视频

控制台

REST

curl

PowerShell

curl

PowerShell

响应

Gen AI SDK for Python

安装

根据图片生成视频

控制台

REST

curl

PowerShell

curl

PowerShell

Gen AI SDK for Python

安装

提示重写器

控制台

REST

curl

PowerShell

后续步骤

Veo | AI 视频生成器