> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Veo 3.1 Fast imagem para vídeo

<Info>
  A API da versão Veo 3.1 Preview foi automaticamente compatibilizada com esta interface
</Info>

Use o modelo de geração de vídeo Veo 3.1 Fast para gerar conteúdo de vídeo de alta qualidade a partir de uma imagem de entrada e uma descrição em texto. Esta interface usa processamento assíncrono, sendo necessário consultar o resultado final gerado por meio do task\_id.

## Cabeçalhos da solicitação

<ParamField header="Content-Type" type="string" required={true}>
  Valores enumerados: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Corpo da solicitação

<ParamField body="prompt" type="string" required={true}>
  String de texto que descreve o vídeo que você deseja gerar.
</ParamField>

<ParamField body="image" type="string" required={false}>
  Imagem de entrada, com suporte a URL ou codificação base64.
</ParamField>

<ParamField body="last_image" type="string" required={false}>
  Imagem final, usada para preencher o último quadro do vídeo. Suporta URL ou codificação base64.
</ParamField>

<ParamField body="aspect_ratio" type="string" required={false}>
  Especifica a proporção do vídeo gerado.

  Valores enumerados: `16:9`, `9:16`. O valor padrão é `16:9`.
</ParamField>

<ParamField body="duration_seconds" type="integer" required={false}>
  Duração (em segundos) do arquivo de vídeo que você deseja gerar.

  Valores enumerados: `4`, `6`, `8`. O valor padrão é `8`.
</ParamField>

<ParamField body="enhance_prompt" type="boolean" required={false}>
  Especifica se o Gemini deve ser usado para aprimorar seu prompt. Suporta apenas `true`.

  Valor padrão: `true`
</ParamField>

<ParamField body="generate_audio" type="boolean" required={true}>
  Especifica se o áudio deve ser gerado para o vídeo.
</ParamField>

<ParamField body="negative_prompt" type="string" required={false}>
  String de texto que descreve o conteúdo que você deseja impedir que o modelo gere.
</ParamField>

<ParamField body="person_generation" type="string" required={false}>
  Configuração de segurança que controla se a geração de pessoas ou rostos é permitida.

  Valores enumerados:

  * `allow_adult` (padrão): permite gerar apenas adultos
  * `dont_allow`: não permite incluir pessoas ou rostos na imagem
  * `allow_all`: permite gerar pessoas de todas as idades (exige que o projeto esteja na allowlist)
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  Resolução do vídeo gerado.

  Valores enumerados: `720p` (padrão) ou `1080p`
</ParamField>

<ParamField body="sample_count" type="integer" required={false}>
  Número de amostras de vídeo a serem geradas.

  Intervalo de valores: 1-4
</ParamField>

<ParamField body="seed" type="uint32" required={false}>
  Número usado para inicializar o processo de geração aleatória. Usar a mesma semente, prompt e outros parâmetros produzirá o mesmo vídeo de saída, tornando o processo de geração determinístico.

  Intervalo de valores: 0-4,294,967,295
</ParamField>

## Parâmetros de informações da resposta

<ResponseField name="task_id" type="string" required={true}>
  O task\_id da tarefa assíncrona. Você deve usar esse task\_id para chamar a [API de consulta do resultado da tarefa](/pt/docs/models/reference-get-async-task-result) para obter o resultado gerado
</ResponseField>