Pular para o conteúdo principal
POST
/
v3
/
async
/
veo-3.1-generate-img2video
Veo 3.1 imagem para vídeo
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "last_image": "<string>",
  "reference_images": [
    {
      "image": "<string>",
      "reference_type": "<string>"
    }
  ],
  "aspect_ratio": "<string>",
  "duration_seconds": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "person_generation": "<string>",
  "resolution": "<string>",
  "sample_count": 123,
  "seed": {}
}
'
{
  "task_id": "<string>"
}
A API da versão Veo 3.1 Preview foi automaticamente compatibilizada com esta interface
Use o modelo de geração de vídeo Veo 3.1 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 requisição

​
Content-Type
string
obrigatório
Valores enumerados: application/json
​
Authorization
string
obrigatório
Formato de autenticação Bearer: Bearer {{API Key}}.

​
Corpo da requisição

​
prompt
string
obrigatório
String de texto que descreve o vídeo que você deseja gerar.
​
image
string
Imagem de entrada, com suporte a URL ou codificação base64.
​
last_image
string
Imagem final, usada para preencher o último quadro do vídeo. Suporta URL ou codificação base64.
​
reference_images
object[]
Lista de até três imagens asset ou até uma imagem style, usada para descrever as imagens de referência que o modelo utilizará ao gerar o vídeo.
​
aspect_ratio
string
Especifica a proporção do vídeo gerado.Valores enumerados: 16:9, 9:16. O valor padrão é 16:9.
​
duration_seconds
integer
Duração do arquivo de vídeo que você deseja gerar (em segundos).Valores enumerados: 4, 6, 8; ao usar reference_images, só pode ser 8.O valor padrão é 8.
​
enhance_prompt
boolean
Especifica se o Gemini deve ser usado para aprimorar seu prompt. Suporta apenas true.Valor padrão: true
​
generate_audio
boolean
obrigatório
Especifica se o áudio deve ser gerado para o vídeo.
​
negative_prompt
string
String de texto que descreve o conteúdo que você deseja impedir que o modelo gere.
​
person_generation
string
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 (requer que o projeto esteja na allowlist)
​
resolution
string
Resolução do vídeo gerado.Valores enumerados: 720p (padrão) ou 1080p
​
sample_count
integer
Número de amostras de vídeo a serem geradas.Intervalo de valores: 1-4
​
seed
uint32
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

​
Parâmetros de informações da resposta

​
task_id
string
obrigatório
O task_id da tarefa assíncrona. Você deve usar esse task_id para solicitar a API de consulta do resultado da tarefa e obter o resultado gerado