自 2025 年 4 月 29 日起，Gemini 1.5 Pro 和 Gemini 1.5 Flash 模型將無法用於先前未使用這些模型的專案，包括新專案。詳情請參閱「模型版本和生命週期」。

本頁面由 Cloud Translation API 翻譯而成。

Veo | AI 影片生成器

您可以在 Vertex AI 運用 Veo，根據您在 Google Cloud 控制台中提供的文字提示或圖片提示，或傳送至 Vertex AI API 的要求，生成新影片。

在 Vertex AI Media Studio 中試用 Veo

在 Colab 中試用 Veo

申請存取權：進階功能和 Veo 候補名單

模型版本

你可以使用多種影片生成模型。詳情請參閱Veo 機型。

位置

位置是您可以在要求中指定的區域，用來控管靜態資料的儲存位置。如需可用區域的清單，請參閱「Vertex AI 的生成式 AI 服務地區」。

負責任的 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 驗證說明文件中的「Authenticate for using REST」。

以文字生成影片

您只需輸入描述性文字，即可生成新穎的影片。下列範例提供生成影片的基本操作說明。

控制台

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

媒體工作室
按一下「影片」。
選用：在「設定」窗格中，設定下列選項：
- 模式：從可用選項中選擇模式。
- 顯示比例：選擇「16:9」或「9:16」。
  
  注意： veo-3.0-generate-preview 不支援 9:16 的顯示比例。
- 結果數量：調整滑桿或輸入介於 1 和 4 之間的值。
- 影片長度：選取 5 秒到 8 秒的長度。
- 輸出目錄：按一下「瀏覽」，建立或選取用於儲存輸出檔案的 Cloud Storage bucket。
選用步驟：在「安全性」部分，選取下列其中一個「人物生成」設定：
- 允許 (僅限成人)：預設值。只能生成成人人物或臉孔。請勿生成青少年、兒童或臉部。
- 不允許：不要生成人物或臉孔。
選用：在「Advanced options」(進階選項) 區段中，輸入 Seed 值，隨機生成影片。
在「撰寫提示」方塊中，輸入描述要生成影片的文字提示。
按一下「生成」。

REST

設定環境後，即可使用 REST 測試文字提示。下列範例會將要求傳送至發布商模型端點。

如要進一步瞭解 Veo API，請參閱 Vertex AI 上的 Veo API。

使用下列指令傳送影片生成要求。這項要求會啟動長時間執行的作業，並將輸出內容儲存至您指定的 Cloud Storage bucket。

使用任何要求資料之前，請先替換以下項目：
- 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。
- 其他選用參數
  
  請視用途使用下列選用變數。在 "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 (GA)
- 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 參考說明文件。

設定環境變數，透過 Vertex AI 使用 Gen AI SDK：

# 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

以圖片生成影片

輸入內容範例	輸出範例
輸入圖片¹ 文字提示：大象自然地移動

¹ 使用 Vertex AI 的 Imagen，根據提示「A Crochet elephant in intricate patterns walking on the savanna」(在熱帶草原上行走的花樣複雜的鉤針大象) 生成的圖片

你只需要輸入圖片，或同時輸入圖片和描述文字，就能生成新穎的影片。下列範例顯示從圖片和文字生成影片的基本指令。

控制台

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

媒體工作室
按一下「影片」。
選用：在「設定」窗格中，設定下列選項：
- 模式：從可用選項中選擇模式。
- 顯示比例：選擇「16:9」或「9:16」。
  
  注意： veo-3.0-generate-preview 不支援 9:16 的顯示比例。
- 結果數量：調整滑桿或輸入介於 1 和 4 之間的值。
- 影片長度：選取 5 秒到 8 秒的長度。
- 輸出目錄：按一下「瀏覽」，建立或選取用於儲存輸出檔案的 Cloud Storage bucket。
選用步驟：在「安全性」部分，選取下列其中一個「人物生成」設定：
- 允許 (僅限成人)：預設值。只能生成成人人物或臉孔。請勿生成青少年、兒童或臉部。
- 不允許：不要生成人物或臉孔。
選用：在「Advanced options」(進階選項) 區段中，輸入 Seed 值，隨機生成影片。
在「撰寫提示」提示方塊中，按一下「上傳」圖示。
選擇要上傳的本機圖片，然後按一下「選取」。
在「撰寫提示」方塊中，輸入描述要生成影片的文字提示。
按一下「生成」。

REST

設定環境後，即可使用 REST 測試文字提示。下列範例會將要求傳送至發布商模型端點。

如要進一步瞭解 Veo API，請參閱 Vertex AI 上的 Veo API。

使用下列指令傳送影片生成要求。這項要求會啟動長時間執行的作業，並將輸出內容儲存至您指定的 Cloud Storage bucket。

使用任何要求資料之前，請先替換以下項目：
- PROJECT_ID：您的 Google Cloud 專案 ID。
- MODEL_ID：要使用的模型 ID。可用值：
  - veo-2.0-generate-001 (GA)
  - 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 參考說明文件。

設定環境變數，透過 Vertex AI 使用 Gen AI SDK：

# 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」Veo。
在「設定」中，按一下「啟用提示強化功能」切換按鈕。
在「撰寫提示」方塊中輸入提示，然後按一下「生成」

REST

如要進一步瞭解 Veo API，請參閱 Vertex AI 上的 Veo API。

使用下列指令傳送影片生成要求。這項要求會啟動長時間執行的作業，並將輸出內容儲存至您指定的 Cloud Storage bucket。

使用任何要求資料之前，請先替換以下項目：
- PROJECT_ID：您的 Google Cloud 專案 ID。
- MODEL_ID：要使用的模型 ID。可用值：
  - veo-2.0-generate-001 (Google 助理許可清單)
  - 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 上推出全新影片和圖片生成模型」網誌文章。
請參閱「New generative media models and tools, built with and for creators」網誌文章。

Veo | AI 影片生成器 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

模型版本

位置

負責任的 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 影片生成器