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
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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 theserviceusage.services.enablepermission. Learn how to grant roles.-
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
No Cloud de Confiance console, acesse a página Agent Platform Studio > Media Studio.
Clique em Veo.
Em Configurações, clique na chave de ativação do aprimoramento de comandos.
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
REST
Para mais informações sobre a API Veo, consulte o seguinte:
- Método:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
- 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
{
"name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}