Você pode usar o Gemini Omni Flash ou o Veo na plataforma de agentes do Gemini Enterprise para orientar a geração de vídeos usando imagens de referência.
Gemini Omni Flash
Com o Gemini Omni Flash, você usa imagens de referência para fornecer mais informações ao modelo ao gerar um vídeo. Os seguintes modelos do Gemini Omni Flash são compatíveis com imagens de referência:
Clique para abrir os modelos compatíveis
Veo
Com o Veo na plataforma de agentes do Gemini Enterprise, você pode usar imagens de referência para direcionar o conteúdo e o estilo artístico do vídeo gerado. Você pode usar uma das seguintes opções ao usar imagens de referência com o Veo:
Imagem do assunto: você fornece até três imagens de uma única pessoa, personagem ou produto. O Veo preserva a aparência do assunto no vídeo de saída.
Os seguintes modelos são compatíveis com a referência de imagem de recurso para vídeo:
Clique para abrir os modelos compatíveis
Imagem de estilo: você fornece uma única imagem de estilo. O Veo aplica o estilo da imagem enviada ao vídeo de saída.
Os seguintes modelos são compatíveis com a imagem de estilo de referência para vídeo:
Clique para abrir os modelos compatíveis
Para mais informações sobre como escrever comandos de texto eficazes para geração de vídeo, consulte o guia de comandos de geração de vídeo.
Teste o Gemini Omni Flash no Colab
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 console Cloud de Confiance para acessar serviços Cloud de Confiance by S3NS e APIs, não é necessário configurar a autenticação.
Python
Para usar os exemplos do Python nesta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.
-
Instale a CLI do Google Cloud.
-
Configure a CLI gcloud para usar sua identidade federada.
Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.
-
Crie credenciais de autenticação local para sua conta de usuário:
gcloud auth application-default login
Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.
Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local na documentação de autenticação do Cloud de Confiance .
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para 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 autenticação do Cloud de Confiance .
-
Usar o Gemini Omni Flash e referências para gerar vídeos
REST
Para mais informações sobre o uso da API Gemini Omni Flash, consulte API Interactions.
A geração de vídeo pode levar mais de um minuto para ser concluída. Para gerar um vídeo para
download imediatamente após a conclusão, use uma solicitação síncrona. Para gerar um
vídeo que pode ser baixado mais tarde, envie uma solicitação assíncrona definindo o parâmetro
background como true. As interações assíncronas são retidas por até 14 dias.
Solicitação síncrona
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
PROJECT_ID: uma string que representa o ID do projeto do Cloud de Confiance by S3NS . -
MODEL_ID: uma string que representa o ID do modelo a ser usado. Os valores aceitos são:"gemini-omni-flash-preview"
-
TEXT_PROMPT: o comando de texto usado para orientar a geração de vídeo. -
CLOUD_STORAGE_INPUT_URI: uma string que representa o bucket do Cloud Storage que contém a mídia de entrada. Por exemplo,"gs://video-bucket/input/". -
CLOUD_STORAGE_OUTPUT_URI: Opcional: uma string que representa 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/". -
ASPECT_RATIO: Opcional: uma string que representa a proporção de tela esperada do vídeo de saída. Se não for fornecida, a proporção será inferida do comando. Os valores aceitos são:"16:9""9:16"
-
DURATION: uma string que representa a duração dos arquivos de vídeo gerados. As strings permitidas são números inteiros entre3e10, seguidos de "s" para segundos. Por exemplo,"10s"
Método HTTP e URL:
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
Corpo JSON da solicitação:
{
"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"
}
}
}
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 TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:
$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",
}
Solicitação assíncrona
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
PROJECT_ID: uma string que representa o ID do projeto do Cloud de Confiance by S3NS . -
MODEL_ID: uma string que representa o ID do modelo a ser usado. Os valores aceitos são:"gemini-omni-flash-preview"
-
TEXT_PROMPT: o comando de texto usado para orientar a geração de vídeo. -
CLOUD_STORAGE_INPUT_URI: uma string que representa o bucket do Cloud Storage que contém a mídia de entrada. Por exemplo,"gs://video-bucket/input/". -
CLOUD_STORAGE_OUTPUT_URI: Opcional: uma string que representa 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/". -
ASPECT_RATIO: Opcional: uma string que representa a proporção de tela esperada do vídeo de saída. Se não for fornecida, a proporção será inferida do comando. Os valores aceitos são:"16:9""9:16"
-
DURATION: uma string que representa a duração dos arquivos de vídeo gerados. As strings permitidas são números inteiros entre3e10, seguidos de "s" para segundos. Por exemplo,"10s"
Método HTTP e URL:
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
Corpo JSON da solicitação:
{
"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"
}
}
}
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 TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:
$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",
"status":"in_progress",
"object":"interaction"
}
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
PROJECT_ID: uma string que representa o ID do projeto do Cloud de Confiance by S3NS . -
INTERACTION_ID: O ID da interação da solicitação assíncrona.
Método HTTP e URL:
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID
Para enviar a solicitação, escolha uma destas opções:
curl
Execute o seguinte comando:
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
Execute o seguinte comando:
$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",
}
Usar o Veo e referências para gerar vídeos
As seções a seguir descrevem como usar o Veo para gerar vídeos com base em referências.
Usar imagens de recursos para gerar vídeos
Faça o seguinte:
Console
No console Cloud de Confiance , acesse a página Agent Platform > Agent Platform Studio .
Clique em Gerar mídia.
Clique em Vídeo.
No menu Tarefa, selecione Referência a vídeo (assunto).
No menu Modelo, selecione uma das opções disponíveis.
Na seção Imagens do assunto, clique em Adicionar.
Uma caixa de diálogo de seleção de arquivos é exibida. Escolha de uma a três imagens no seu computador para fazer upload.
Opcional: na seção Parâmetros, ajuste as seguintes configurações:
- Proporção: selecione 16:9 ou 9:16.
- Número de resultados: ajuste o controle deslizante ou insira um valor entre 1 e 4.
- Duração do vídeo: selecione 8, 6 ou 4 segundos.
- Resolução de saída: selecione uma das seguintes opções:
- 720p
- 1080p
- 4k
Opcional: na seção Segurança, selecione uma das seguintes configurações de Geração de pessoas:
Permitir (somente adultos): valor padrão. Gerar apenas pessoas ou rostos adultos. Não gere pessoas ou rostos de jovens ou crianças.
Não permitir: não gera pessoas nem rostos.
Opcional: na seção Opções avançadas, insira um valor de Seed para aleatorizar a geração de vídeo.
Na caixa Comando, insira o comando de texto que descreve os vídeos a serem gerados.
Clique em Executar.
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 da 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:
- Método:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
Use os comandos 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: o ID do projeto do Cloud de Confiance by S3NS . -
MODEL_ID: uma string que representa o ID do modelo a ser usado. Os seguintes modelos são compatíveis: -
TEXT_PROMPT: o comando de texto usado para orientar a geração de vídeo. -
BASE64_ENCODED_IMAGE: uma imagem do assunto codificada em bytes base64. Você pode repetir esse campo emimeTypepara especificar até três imagens de assunto. -
IMAGE_MIME_TYPE: o tipo MIME da imagem de entrada. Apenas uma das opções a seguir:image/jpegimage/png
Você pode repetir esse campo e
bytesBase64Encodedpara especificar até três imagens de assunto. -
ASPECT_RATIO: opcional: a proporção do vídeo gerado. Apenas uma das opções a seguir:"16:9""9:16"
O valor padrão é
"16:9". -
OUTPUT_STORAGE_URI: Opcional: o bucket do Cloud Storage para armazenar os vídeos de saída. Se não for fornecido, um vídeo codificado em bytes Base64 será retornado 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. -
VIDEO_RESOLUTION: Opcional: a resolução do vídeo gerado. Apenas uma das seguintes opções:"720p""1080p""4k"(somente modelos de pré-lançamento do Veo 3.1)
O valor padrão é
"720p". -
Outros parâmetros opcionais
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. 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 somente a geração de pessoas e rostos adultos. -
"disallow": não gera pessoas nem rostos.
O valor padrão é
"allow_adult". -
-
RESOLUTION: Opcional: um valor de string que controla a resolução do vídeo gerado. 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. Especificar um número de sugestão com sua solicitação sem mudar outros parâmetros orienta o modelo a produzir os mesmos vídeos. O intervalo aceito de valores é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", // 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 } }Para enviar a solicitação, escolha uma destas opções:
Essa solicitação retorna um nome de operação completo com um ID exclusivo. Use esse nome completo para pesquisar o status da solicitação de geração de vídeo.curl
Salve o corpo da solicitação em um arquivo com o nome
request.jsone execute o comando abaixo: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.jsone 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" }-
Opcional: verifique o status da operação de longa duração de geração de vídeo.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .
- MODEL_ID: o ID do modelo a ser usado.
- OPERATION_ID: o ID de operação exclusivo retornado na solicitação original de geração de vídeo.
Método HTTP e URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation
Corpo JSON da solicitação:
{ "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID" }Para enviar a solicitação, escolha uma destas opções:
Essa solicitação retorna informações sobre a operação, incluindo se ela ainda está em execução ou se já foi concluída.curl
Salve o corpo da solicitação em um arquivo com o nome
request.jsone execute o comando abaixo: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
Salve o corpo da solicitação em um arquivo com o nome
request.jsone 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:fetchPredictOperation" | Select-Object -Expand Content
Usar imagens de estilo para gerar vídeos
Faça o seguinte:
Console
No console Cloud de Confiance , acesse a página Agent Platform > Agent Platform Studio .
Clique em Gerar mídia.
Clique em Vídeo.
No menu Tarefa, selecione Referência a vídeo (estilo).
No menu Modelo, selecione uma das opções disponíveis.
Na seção Imagem de estilo, clique em Adicionar.
Uma caixa de diálogo de seleção de arquivos é exibida. Escolha uma imagem no seu computador para fazer upload.
Opcional: na seção Parâmetros, ajuste as seguintes configurações:
- Proporção: selecione 16:9 ou 9:16.
- Número de resultados: ajuste o controle deslizante ou insira um valor entre 1 e 4.
- Duração do vídeo: selecione 8, 7, 6 ou 5 segundos.
Opcional: na seção Segurança, selecione uma das seguintes configurações de Geração de pessoas:
Permitir (somente adultos): valor padrão. Gerar apenas pessoas ou rostos adultos. Não gere pessoas ou rostos de jovens ou crianças.
Não permitir: não gera pessoas nem rostos.
Opcional: na seção Opções avançadas, insira um valor de Seed para aleatorizar a geração de vídeo.
Na caixa Comando, insira o comando de texto que descreve os vídeos a serem gerados.
Clique em Executar.
REST
Para mais informações sobre a API Veo, consulte a API Veo na Gemini Enterprise Agent Platform.
Use os comandos 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: o ID do projeto do Cloud de Confiance by S3NS . -
MODEL_ID: uma string que representa o ID do modelo a ser usado. Os seguintes modelos são compatíveis: -
TEXT_PROMPT: o comando de texto usado para orientar a geração de vídeo. -
BASE64_ENCODED_IMAGE: uma imagem de estilo codificada em bytes base64. -
IMAGE_MIME_TYPE: o tipo MIME da imagem de entrada. Apenas uma das seguintes opções:image/jpegimage/png
-
OUTPUT_STORAGE_URI: Opcional: o bucket do Cloud Storage para armazenar os vídeos de saída. Se não for informado, os bytes do 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. -
Outros parâmetros opcionais
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. 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 somente a geração de pessoas e rostos adultos. -
"disallow": não gera pessoas nem rostos.
O valor padrão é
"allow_adult". -
-
RESOLUTION: Opcional: um valor de string que controla a resolução do vídeo gerado. 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. Especificar um número de sugestão com sua solicitação sem mudar outros parâmetros orienta o modelo a produzir os mesmos vídeos. O intervalo aceito de valores é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", "referenceImages": [ { "image": { "bytesBase64Encoded": "BASE64_ENCODED_IMAGE", "mimeType": "IMAGE_MIME_TYPE" }, "referenceType": "style" } ] } ], "parameters": { "durationSeconds": 8, "storageUri": "OUTPUT_STORAGE_URI", "sampleCount": RESPONSE_COUNT } }Para enviar a solicitação, escolha uma destas opções:
Essa solicitação retorna um nome de operação completo com um ID exclusivo. Use esse nome completo para pesquisar o status da solicitação de geração de vídeo.curl
Salve o corpo da solicitação em um arquivo com o nome
request.jsone execute o comando abaixo: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.jsone 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" }-
Opcional: verifique o status da operação de longa duração de geração de vídeo.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .
- MODEL_ID: o ID do modelo a ser usado.
- OPERATION_ID: o ID de operação exclusivo retornado na solicitação original de geração de vídeo.
Método HTTP e URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation
Corpo JSON da solicitação:
{ "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID" }Para enviar a solicitação, escolha uma destas opções:
Essa solicitação retorna informações sobre a operação, incluindo se ela ainda está em execução ou se já foi concluída.curl
Salve o corpo da solicitação em um arquivo com o nome
request.jsone execute o comando abaixo: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
Salve o corpo da solicitação em um arquivo com o nome
request.jsone 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:fetchPredictOperation" | Select-Object -Expand Content