使用素材資源和風格圖片引導影片生成作業

您可以在 Gemini Enterprise Agent Platform 使用 Gemini Omni Flash 或 Veo，透過參考圖片引導影片生成作業。

Gemini Omni Flash

使用 Gemini Omni Flash 生成影片時，您可以提供參考圖片，為模型提供額外輸入內容。下列 Gemini Omni Flash 模型支援參考圖片：

按一下即可展開支援的機型

Veo

Gemini Enterprise Agent Platform 的 Veo 可讓您使用參考圖片，引導生成的影片內容和藝術風格。使用 Veo 參考圖片時，你可以選擇下列其中一種方式：

  • 主體圖片：最多提供三張圖片，內容可以是同一個人、角色或產品。Veo 會在輸出影片中保留主體的外觀。

    下列模型支援從參考素材資源圖片生成影片：

    按一下即可展開支援的機型

  • 風格圖片：提供單一風格圖片。Veo 會將上傳圖像的風格套用至輸出影片。

    下列模型支援參考樣式圖片轉影片：

    按一下即可展開支援的機型

如要進一步瞭解如何撰寫有效提示來生成影片，請參閱影片生成提示指南。

在 Colab 中試用 Gemini Omni Flash

在 Colab 中試用 Veo

事前準備

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Enable the Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  3. 為環境設定驗證機制。

    選取這個頁面上您打算如何使用範例的分頁：

    控制台

    使用 Cloud de Confiance 控制台存取 Cloud de Confiance by S3NS 服務和 API 時，無須設定驗證。

    Python

    如要在本機開發環境中使用本頁的 Python 範例，請安裝並初始化 gcloud CLI，然後使用您的使用者憑證設定應用程式預設憑證。

    1. 安裝 Google Cloud CLI。

    2. 設定 gcloud CLI，使用您的聯合身分。

      詳情請參閱「使用聯合身分登入 gcloud CLI」。

    3. 為使用者帳戶建立本機驗證憑證： 

      gcloud auth application-default login

      如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。

    詳情請參閱 Cloud de Confiance 驗證說明文件中的「 為本機開發環境設定 ADC」。

    REST

    如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

      安裝 Google Cloud CLI，然後 使用聯合身分登入 gcloud CLI。

    詳情請參閱 Cloud de Confiance 驗證說明文件中的「使用 REST 進行驗證」。

使用 Gemini Omni Flash 和參考資料生成影片

REST

如要進一步瞭解如何使用 Gemini Omni Flash API，請參閱「Interactions API」。

生成影片可能需要一分鐘以上。如要生成影片並在完成後立即下載，請使用同步要求。如要生成可供日後下載的影片，請將 background 參數設為 true，藉此傳送非同步要求。非同步互動最多會保留 14 天。

同步要求

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：代表 Cloud de Confiance by S3NS 專案 ID 的字串。
  • MODEL_ID：代表要使用的模型 ID 的字串。可接受的值如下：
    • "gemini-omni-flash-preview"
  • TEXT_PROMPT：用來引導影片生成的文字提示。
  • CLOUD_STORAGE_INPUT_URI：代表包含輸入媒體的 Cloud Storage bucket 的字串。例如："gs://video-bucket/input/"。
  • CLOUD_STORAGE_OUTPUT_URI： 選用：代表 Cloud Storage bucket 的字串，用於儲存輸出影片。如果未提供，回應中會傳回影片位元組。 例如："gs://video-bucket/output/"。
  • ASPECT_RATIO： 選用：代表輸出影片預期顯示比例的字串。如未提供，系統會根據提示推斷顯示比例。 可接受的值如下：
    • "16:9"
    • "9:16"
  • DURATION：代表生成影片檔案長度的字串。允許的字串為介於 3 和 10 之間的整數，後接「s」代表秒數。例如："10s「

HTTP 方法和網址：

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

JSON 要求內文：

{
  "model": "MODEL_ID",
  "input": [
    {
      "type": "text",
      "text": "TEXT_PROMPT"
    },
    {
      "type": "image",
      "uri": "CLOUD_STORAGE_INPUT_URI",
      "mime_type": "image/png"
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "aspect_ratio": "ASPECT_RATIO",
      "duration": "DURATION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "reference_to_video"
    }
  }
}

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"

PowerShell

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
回覆包含互動，其中包含模型想法和輸出影片。 
{
  "id":"INTERACTION_ID",
  "model":"gemini-omni-flash-preview",
  "status":"completed",
  "usage":{
    "total_tokens":479,
    "total_input_tokens":26,
    "input_tokens_by_modality":[
      {
        "modality":"text",
        "tokens":26
      },
      {
        "modality":"image",
        "tokens":124
      }
    ],
    "output_tokens_by_modality": [
      {
        "modality": "video",
        "tokens": 28832
      }
    ],
    "total_output_tokens":28832,
    "total_thought_tokens":453
  },
  "steps":[
    {
      "type":"thought",
      "summary":[
        {
          "type":"text",
          "text":"MODEL THOUGHTS"
        }
      ],
    },
    { 
      "type":"model_output",
      "content":[
        {
          "type":"video",
          "uri":"gs://some/output_path/123.mp4",
          "mime_type":"video/mp4" 
        }
      ]
    }
  ],
  "object":"interaction"
  "role":"model",
  "created":"2026-05-29T02:17:56Z",
  "updated":"2026-05-29T02:17:56Z",
}

非同步要求

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：代表 Cloud de Confiance by S3NS 專案 ID 的字串。
  • MODEL_ID：代表要使用的模型 ID 的字串。可接受的值如下：
    • "gemini-omni-flash-preview"
  • TEXT_PROMPT：用來引導影片生成的文字提示。
  • CLOUD_STORAGE_INPUT_URI：代表包含輸入媒體的 Cloud Storage bucket 的字串。例如："gs://video-bucket/input/"。
  • CLOUD_STORAGE_OUTPUT_URI： 選用：代表 Cloud Storage bucket 的字串，用於儲存輸出影片。如果未提供，回應中會傳回影片位元組。 例如："gs://video-bucket/output/"。
  • ASPECT_RATIO： 選用：代表輸出影片預期顯示比例的字串。如未提供，系統會根據提示推斷顯示比例。 可接受的值如下：
    • "16:9"
    • "9:16"
  • DURATION：代表生成影片檔案長度的字串。允許的字串為介於 3 和 10 之間的整數，後接「s」代表秒數。例如："10s「

HTTP 方法和網址：

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

JSON 要求內文：

{
  "model": "MODEL_ID",
  "input": [
    {
      "background": true,
      "type": "text",
      "text": "TEXT_PROMPT"
    },
    {
      "type": "image",
      "uri": "CLOUD_STORAGE_INPUT_URI",
      "mime_type": "image/png"
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "aspect_ratio": "ASPECT_RATIO",
      "duration": "DURATION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "reference_to_video"
    }
  }
}

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"

PowerShell

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
回覆會包含互動 ID，您將使用這個 ID 取得生成的影片。 
{
  "id":"INTERACTION_ID",
  "status":"in_progress",
  "object":"interaction"
}
稍後，使用 INTERACTION_ID 取得生成的影片：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：代表 Cloud de Confiance by S3NS 專案 ID 的字串。
  • INTERACTION_ID： 非同步要求的互動 ID。

HTTP 方法和網址：

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令： 

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID"

PowerShell

執行下列指令： 

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID" | Select-Object -Expand Content
回應格式如下： 
{
  "id":"INTERACTION_ID",
  "model":"gemini-omni-flash-preview",
  "status":"completed",
  "usage":{
    "total_tokens":479,
    "total_input_tokens":26,
    "input_tokens_by_modality":[
      {
        "modality":"text",
        "tokens":26
      },
      {
        "modality":"image",
        "tokens":124
      }
    ],
    "output_tokens_by_modality": [
      {
        "modality": "video",
        "tokens": 28832
      }
    ],
    "total_output_tokens":28832,
    "total_thought_tokens":453
  },
  "steps":[
    {
      "type": "user_input",
      "content": [
        {
          "type": "text",
          "text": "5 second, 9:16 video. Use the image as the first frame."
        },
        {
          "type": "image",
          "uri": "gs://some/path",
          "mime_type": "image/png"
        }
      ]
    },
    {
      "type":"thought"
      "summary":[
        {
          "type":"text",
          "text":"MODEL THOUGHTS"
        }
      ],
    },
    { 
      "type":"model_output",
      "content":[
        {
          "type":"video",
          "data":"VIDEO DATA",
          "mime_type":"video/mp4" 
        }
      ]
    }
  ],
  "object":"interaction"
  "role":"model",
  "created":"2026-05-29T02:17:56Z",
  "updated":"2026-05-29T02:17:56Z",
}

使用 Veo 和參考資料生成影片

以下章節說明如何使用 Veo 從參考資料生成影片。

使用素材資源圖片生成影片

請執行下列步驟：

控制台

  1. 在 Cloud de Confiance 控制台中，依序前往「Agent Platform」>「Agent Platform Studio」 頁面。

    前往 Agent Platform Studio

  2. 按一下「生成媒體」。

  3. 按一下「影片」。

  4. 在「Task」選單中，選取「Reference-to-video (Subject)」。

  5. 在「模型」選單中，從可用選項選取模型。

  6. 在「主體圖片」部分中，按一下「新增」。

    系統會顯示檔案選取對話方塊。選擇電腦上的一到三張圖片上傳。

  7. 選用：在「Parameters」部分中，調整下列設定：

    • 顯示比例：選取「16:9」或「9:16」。
    • 結果數量：調整滑桿或輸入介於 1 和 4 之間的值。
    • 影片長度：選取 8、6 或 4 秒。
    • 輸出內容解析度：選取下列其中一個選項：
      • 720p
      • 1080p
      • 4k

  8. 選用步驟：在「安全性」部分，選取下列其中一個「人物生成」設定：

    • 允許 (僅限成人)：預設值。只能生成成人人物或臉孔。請勿生成青少年、兒童或臉部。

    • 不允許：不要生成人物或臉孔。

  9. 選用：在「Advanced options」(進階選項) 區段中，輸入「Seed」(種子) 值，隨機生成影片。

  10. 在「提示」方塊中，輸入描述要生成影片的文字提示。

  11. 按一下「執行」。

Python

安裝

pip install --upgrade google-genai

詳情請參閱 SDK 參考說明文件。

設定環境變數，透過 Vertex AI 使用 Google 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_ENTERPRISE=True
 

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

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.1-generate-preview",
    prompt="A person walks in carrying a vase full of flowers and places the vase on a kitchen table.",
    config=GenerateVideosConfig(
        reference_images=[
            VideoGenerationReferenceImage(
                image=Image(
                    gcs_uri="gs://cloud-samples-data/generative-ai/image/vase.png",
                    mime_type="image/png",
                ),
                reference_type="asset",
            ),
        ],
        aspect_ratio="9:16",
        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

REST

如要進一步瞭解 Veo API，請參閱下列內容：

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

    使用任何要求資料之前，請先修改下列項目的值：

    • PROJECT_ID：您的 Cloud de Confiance by S3NS 專案 ID。
    • MODEL_ID：代表要使用模型 ID 的字串。支援的機型如下：
        <0x0
    • TEXT_PROMPT：用於引導影片生成的文字提示。
    • BASE64_ENCODED_IMAGE：採用 base64 位元組編碼的主體圖片。您可以重複這個欄位和 mimeType，最多指定三張主體圖片。

    • IMAGE_MIME_TYPE：輸入圖片的 MIME 類型。只能是下列其中一項：

      • image/jpeg
      • image/png

      您可以重複這個欄位和 bytesBase64Encoded，最多指定三張主體圖片。

    • ASPECT_RATIO：選用： 生成的影片顯示比例。只能是下列其中一項：

      • "16:9"
      • "9:16"

      預設值為 "16:9"。

    • OUTPUT_STORAGE_URI： 選用：用於儲存輸出影片的 Cloud Storage bucket。如果未提供，回應中會傳回 Base64 位元組編碼的影片。例如：gs://video-bucket/output/。
    • RESPONSE_COUNT：要生成的影片檔案數量。接受的整數值：1 到 4。

    • VIDEO_RESOLUTION： 選用：生成的影片解析度。只能是下列其中一項：

      • "720p"
      • "1080p"
      • "4k" (僅限 Veo 3.1 預先發布版模型)

      預設值為 "720p"。

    • 其他選用參數

      視用途而定，您可以使用下列選用變數。在 "parameters": {} 物件中新增下列部分或所有參數。 

      "parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  // "resolution": RESOLUTION, // Veo 3 models only
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
      • ASPECT_RATIO： 選用：描述生成影片顯示比例的字串值。您可以使用下列值：
        • "16:9" 橫向
        • "9:16" 直向

        預設值為 "16:9"

      • NEGATIVE_PROMPT：選用：字串值，說明您要禁止模型生成哪些內容。
      • PERSON_SAFETY_SETTING： 選用：控制生成人物或臉部安全設定的字串值。您可以使用下列值：
        • "allow_adult"：只允許生成成人人物和臉孔。
        • "disallow"：不會生成人物或臉部。

        預設值為 "allow_adult"。

      • RESOLUTION： 選用：控制生成影片解析度的字串值。僅支援 Veo 3 模型。你可以使用下列值：
        • "720p"
        • "1080p"
        • "4k" (僅限 Veo 3.1 預先發布版模型)

        預設值為 "720p"。

      • RESPONSE_COUNT： 選用。整數值，說明要生成的影片數量。 可接受的值範圍為 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",
      // The following fields can be repeated for up to three total
      // images.
      "referenceImages": [
        {
          "image": {
            "bytesBase64Encoded": "BASE64_ENCODED_IMAGE",
            "mimeType": "IMAGE_MIME_TYPE"
          },
          "referenceType": "asset"
        }
      ]
    }
  ],
  "parameters": {
    "aspectRatio":, "ASPECT_RATIO,
    "durationSeconds": 8,
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": RESPONSE_COUNT,
    "resolution": "VIDEO_RESOLUTION
  }
}

    如要傳送要求，請選擇以下其中一個選項：

    curl

    將要求主體儲存在名為 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

    將要求主體儲存在名為 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"
}

  2. 選用：檢查影片生成長時間執行作業的狀態。

    使用任何要求資料之前，請先修改下列項目的值：

    • PROJECT_ID：您的 Cloud de Confiance by S3NS 專案 ID。
    • MODEL_ID：要使用的模型 ID。
    • 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

    將要求主體儲存在名為 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

    將要求主體儲存在名為 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
    這項要求會傳回作業相關資訊，包括作業是否仍在執行中或已完成。

使用風格圖片生成影片

請執行下列步驟：

控制台

  1. 在 Cloud de Confiance 控制台中，依序前往「Agent Platform」>「Agent Platform Studio」 頁面。

    前往 Agent Platform Studio

  2. 按一下「生成媒體」。

  3. 按一下「影片」。

  4. 在「Task」選單中，選取「Reference-to-video (Style)」。

  5. 在「模型」選單中，從可用選項選取模型。

  6. 在「風格圖片」部分，按一下「新增」。

    系統會顯示檔案選取對話方塊。選擇要上傳的電腦圖片。

  7. 選用：在「Parameters」部分中，調整下列設定：

    • 顯示比例：選取「16:9」或「9:16」。
    • 結果數量：調整滑桿或輸入介於 1 和 4 之間的值。
    • 影片長度：選取 8、7、6 或 5 秒。

  8. 選用步驟：在「安全性」部分，選取下列其中一個「人物生成」設定：

    • 允許 (僅限成人)：預設值。只能生成成人人物或臉孔。請勿生成青少年、兒童或臉部。

    • 不允許：不要生成人物或臉孔。

  9. 選用：在「Advanced options」(進階選項) 區段中，輸入「Seed」(種子) 值，隨機生成影片。

  10. 在「提示」方塊中，輸入描述要生成影片的文字提示。

  11. 按一下「執行」。

REST

如要進一步瞭解 Veo API，請參閱 Gemini Enterprise Agent Platform 中的 Veo API。

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

    使用任何要求資料之前，請先修改下列項目的值：

    • PROJECT_ID：您的 Cloud de Confiance by S3NS 專案 ID。

    • MODEL_ID：代表要使用模型 ID 的字串。支援的機型如下：

    • TEXT_PROMPT：用於引導影片生成的文字提示。
    • BASE64_ENCODED_IMAGE：採用 base64 位元組編碼的樣式圖片。
    • IMAGE_MIME_TYPE：輸入圖片的 MIME 類型。只能是下列其中一項：
      • image/jpeg
      • image/png
    • OUTPUT_STORAGE_URI： 選用：用於儲存輸出影片的 Cloud Storage bucket。如果未提供，回應中會傳回影片位元組。例如： gs://video-bucket/output/。
    • RESPONSE_COUNT：要生成的影片檔案數量。接受的整數值：1 到 4。

    • 其他選用參數

      視用途而定，您可以使用下列選用變數。在 "parameters": {} 物件中新增下列部分或所有參數。 

      "parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  // "resolution": RESOLUTION, // Veo 3 models only
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
      • ASPECT_RATIO： 選用：描述生成影片顯示比例的字串值。您可以使用下列值：
        • "16:9" 橫向
        • "9:16" 直向

        預設值為 "16:9"

      • NEGATIVE_PROMPT：選用：字串值，說明您要禁止模型生成哪些內容。
      • PERSON_SAFETY_SETTING： 選用：控制生成人物或臉部安全設定的字串值。您可以使用下列值：
        • "allow_adult"：只允許生成成人人物和臉孔。
        • "disallow"：不會生成人物或臉部。

        預設值為 "allow_adult"。

      • RESOLUTION： 選用：控制生成影片解析度的字串值。僅支援 Veo 3 模型。你可以使用下列值：
        • "720p"
        • "1080p"
        • "4k" (僅限 Veo 3.1 預先發布版模型)

        預設值為 "720p"。

      • RESPONSE_COUNT： 選用。整數值，說明要生成的影片數量。 可接受的值範圍為 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",
      "referenceImages": [
        {
          "image": {
            "bytesBase64Encoded": "BASE64_ENCODED_IMAGE",
            "mimeType": "IMAGE_MIME_TYPE"
          },
          "referenceType": "style"
        }
      ]
    }
  ],
  "parameters": {
    "durationSeconds": 8,
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": RESPONSE_COUNT
  }
}

    如要傳送要求，請選擇以下其中一個選項：

    curl

    將要求主體儲存在名為 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

    將要求主體儲存在名為 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"
}

  2. 選用：檢查影片生成長時間執行作業的狀態。

    使用任何要求資料之前，請先修改下列項目的值：

    • PROJECT_ID：您的 Cloud de Confiance by S3NS 專案 ID。
    • MODEL_ID：要使用的模型 ID。
    • 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

    將要求主體儲存在名為 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

    將要求主體儲存在名為 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
    這項要求會傳回作業相關資訊，包括作業是否仍在執行中或已完成。

後續步驟