Desativar a reescrita de comandos da Veo na Gemini Enterprise Agent Platform

O Veo oferece uma ferramenta de aprimoramento de comandos baseada em LLM, também conhecida como reescritor de comandos. O reescritor de comandos oferece a opção de reescrever seus comandos para adicionar descrição de vídeo, movimentos de câmera, transcrição e efeitos sonoros ao comando. Comandos mais detalhados resultam em vídeos de maior qualidade.

Se você desativar o aprimoramento de comandos, a qualidade dos vídeos e a semelhança da saída com o comando fornecido poderão ser afetadas. Esse recurso é ativado por padrão para veo-2.0-generate-001.

Um comando reescrito é entregue pela resposta da API somente se o comando original tiver menos de 30 palavras.

Para mais informações sobre como escrever comandos de texto eficazes para geração de vídeo, consulte o guia de comandos do Veo.

Antes de começar

  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. Configure a autenticação do ambiente.

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o Cloud de Confiance console para acessar Cloud de Confiance by S3NS serviços e APIs, não é necessário configurar a autenticação.

    REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de Cloud de Confiance autenticação.

Desativar o reescritor de comandos

Para desativar o aprimoramento de comandos, faça o seguinte:

Console

  1. No Cloud de Confiance console, acesse a página Agent Platform Studio > Media Studio.

    Acessar o Media Studio

  2. Clique em Veo.

  3. Em Configurações, clique na chave de ativação do aprimoramento de comandos.

  4. Na caixa Escreva seu comando, insira o comando e clique em Gerar.

Python

Instalar

pip install --upgrade google-genai

Para saber mais, consulte a documentação de referência do SDK.

Defina variáveis de ambiente para usar o SDK de IA Generativa do Google com a 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_ENTERPRISE=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

Para mais informações sobre a API Veo, consulte o seguinte:

  1. Use o comando a seguir para enviar uma solicitação de geração de vídeo. Essa solicitação inicia uma operação de longa duração e armazena a saída em um bucket do Cloud Storage especificado por você.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: seu Cloud de Confiance by S3NS ID do projeto.
  • MODEL_ID: o ID do modelo a ser usado. Valores disponíveis:
    • veo-2.0-generate-001
  • TEXT_PROMPT: o comando de texto usado para orientar a geração de vídeo.
  • OUTPUT_STORAGE_URI: opcional: o bucket do Cloud Storage para armazenar os vídeos de saída. Se não for fornecido, os bytes de vídeo serão retornados na resposta. Por exemplo: gs://video-bucket/output/.
  • RESPONSE_COUNT: o número de arquivos de vídeo que você quer gerar. Valores inteiros aceitos: 1 a 4.
  • DURATION: a duração dos arquivos de vídeo que você quer gerar. Os valores inteiros aceitos são de 5 a 8.
  • ENHANCED_PROMPT: se você quer usar comandos aprimorados ou não. Você pode usar um dos seguintes:
    • True: (padrão) use o Gemini para aprimorar seus comandos.
    • False: não use o Gemini para aprimorar seus comandos.
  • Parâmetros opcionais adicionais

    Use as seguintes variáveis opcionais dependendo do seu caso de uso. Adicione alguns ou todos os parâmetros a seguir no objeto "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: opcional: um valor de string que descreve a proporção dos vídeos gerados vídeos. Você pode usar os seguintes valores:
      • "16:9" para paisagem
      • "9:16" para retrato

      O valor padrão é "16:9"

    • NEGATIVE_PROMPT: opcional: um valor de string que descreve o conteúdo que você quer impedir que o modelo gere.
    • PERSON_SAFETY_SETTING: opcional: um valor de string que controla a configuração de segurança para gerar pessoas ou rostos. Você pode usar os seguintes valores:
      • "allow_adult": permite apenas a geração de pessoas e rostos adultos.
      • "disallow": não gera pessoas ou rostos.

      O valor padrão é "allow_adult".

    • RESOLUTION: opcional: um valor de string que controla a resolução do vídeo gerado vídeo. Compatível apenas com modelos do Veo 3. Você pode usar os seguintes valores:
      • "720p"
      • "1080p"
      • "4k" (somente modelos de pré-lançamento do Veo 3.1)

      O valor padrão é "720p".

    • RESPONSE_COUNT: Opcional. Um valor inteiro que descreve o número de vídeos a serem gerados. O intervalo de valores aceito é 1-4.
    • SEED_NUMBER: Opcional. Um valor uint32 que o modelo usa para gerar vídeos determinísticos vídeos. Especificar um número de sugestão com sua solicitação sem alterar outros parâmetros orienta o modelo a produzir os mesmos vídeos. O intervalo de valores aceito é 0-4294967295.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT",
    "durationSeconds": "DURATION",
    "enhancePrompt": ENHANCED_PROMPT
  }
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

Salve o corpo da solicitação em um arquivo com o nome request.json, e execute o comando abaixo:

$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
Essa solicitação retorna um nome de operação completo com um ID de operação exclusivo. Use esse nome de operação completo para consultar o status da solicitação de geração de vídeo.
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}

A seguir