關閉提示重寫功能

Veo 提供以 LLM 為基礎的提示強化工具，又稱為提示重寫工具。提示重寫器可重寫提示，在提示中加入影片說明、攝影機動作、轉錄稿和音效。提示詞越詳細，影片品質就越高。

如果停用提示強化功能，影片品質和輸出內容與所提供提示的相似程度可能會受到影響。這項功能預設為 veo-2.0-generate-001 啟用。

只有在原始提示少於 30 個字時，API 回應才會提供改寫的提示。

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

事前準備

  1. 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.

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

    Go to project selector

  3. Enable the Vertex AI API.

    Enable the API

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

    Go to project selector

  5. Enable the Vertex AI API.

    Enable the API

    6.

  6. 為環境設定驗證方法。

    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 的憑證。

      安裝 Google Cloud CLI。 安裝完成後，執行下列指令初始化 Google Cloud CLI： 

      gcloud init

      如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

    詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。

    關閉提示重寫工具

    如要關閉提示強化功能，請按照下列步驟操作：

    控制台

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

      前往媒體工作室

    2. 按一下「Veo」Veo。

    3. 在「設定」中，按一下「啟用提示強化功能」切換按鈕。

    4. 在「撰寫提示」方塊中輸入提示，然後按一下 「生成」。

    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-2.0-generate-001",
    prompt="a cat reading a book",
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        output_gcs_uri=output_gcs_uri,
        number_of_videos=1,
        duration_seconds=5,
        person_generation="dont_allow",
        enhance_prompt=False,
    ),
)

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

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

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

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

    使用任何要求資料之前，請先替換以下項目：

    • PROJECT_ID：您的 Google Cloud 專案 ID。
    • MODEL_ID：要使用的模型 ID。可用值：
      • veo-2.0-generate-001
    • TEXT_PROMPT：用於引導影片生成的文字提示。
    • OUTPUT_STORAGE_URI：選用：用於儲存輸出影片的 Cloud Storage bucket。如果未提供，回應中會傳回影片位元組。例如：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",
  // "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"

        預設值為 "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"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT",
    "durationSeconds": "DURATION",
    "enhancePrompt": ENHANCED_PROMPT
  }
}

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

    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"
}

    後續步驟