Pular para o conteúdo principal
POST
/
v3
/
async
/
veo-3.1-generate-reference
Veo 3.1 Geração de vídeo com imagem de referência
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-reference \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "prompt": "<string>",
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "sample_count": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "reference_images": [
    {}
  ],
  "person_generation": "<string>"
}
'
{
  "task_id": "<string>"
}
Use o modelo Google Veo 3.1 para gerar vídeos orientados por 1 a 3 imagens de referência. Compatível com resoluções 720p e 1080p, e proporções 16:9 e 9:16. A duração é fixa em 8 segundos. O tipo de referência é compatível apenas com asset.
Esta é uma API assíncrona e retorna apenas o task_id da tarefa assíncrona. Você deve usar esse task_id para solicitar a API de consulta de resultado da tarefa para recuperar o resultado gerado.

​
Cabeçalhos da solicitação

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

​
Corpo da solicitação

​
seed
integer
Semente aleatória, usada para reproduzir os resultados gerados.Intervalo de valores: [0, 4294967295]
​
prompt
string
obrigatório
Prompt de texto que descreve o conteúdo esperado do vídeo.
​
resolution
string
padrão:"720p"
Resolução do vídeo de saída.Valores opcionais: 720p, 1080p
​
aspect_ratio
string
padrão:"16:9"
Proporção do vídeo de saída.Valores opcionais: 16:9, 9:16
​
sample_count
integer
padrão:1
Quantidade de amostras de vídeo a serem geradas (1-4).Intervalo de valores: [1, 4]
​
enhance_prompt
boolean
padrão:true
Se deve usar IA para reescrever o prompt a fim de obter melhores resultados de geração.
​
generate_audio
boolean
padrão:false
Se deve gerar áudio simultaneamente.
​
negative_prompt
string
Descreve o conteúdo que deve ser evitado no vídeo gerado.
​
reference_images
array
obrigatório
1 a 3 imagens de referência, usadas para orientar a geração do vídeo. Cada elemento contém uma URL de imagem ou dados codificados em Base64 e o tipo de referência.Comprimento do array: 1 - 3
​
person_generation
string
padrão:"allow_adult"
Se permite gerar pessoas adultas. allow_adult: permite gerar adultos; dont_allow: não permite gerar pessoas.Valores opcionais: allow_adult, dont_allow

​
Informações da resposta

​
task_id
string
Use o task_id para solicitar a API de consulta de resultado da tarefa para recuperar a saída gerada.