Saltar al contenido principal
POST
/
v3
/
async
/
veo-3.1-generate-reference
Generación de video con imágenes de referencia en Veo 3.1
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 el modelo Google Veo 3.1 para generar videos guiados por 1-3 imágenes de referencia. Admite resoluciones 720p y 1080p, y relaciones de aspecto 16:9 y 9:16. La duración es fija de 8 segundos. El tipo de referencia solo admite asset.
Esta es una API asíncrona y solo devolverá el task_id de la tarea asíncrona. Debe usar ese task_id para solicitar la API de consulta del resultado de la tarea y recuperar el resultado generado.

​
Encabezados de solicitud

​
Content-Type
string
requerido
Valores enumerados: application/json
​
Authorization
string
requerido
Formato de autenticación Bearer: Bearer {{clave de API}}.

​
Cuerpo de la solicitud

​
seed
integer
Semilla aleatoria, usada para reproducir los resultados de generación.Rango de valores: [0, 4294967295]
​
prompt
string
requerido
Texto de prompt que describe el contenido de video esperado.
​
resolution
string
predeterminado:"720p"
Resolución del video de salida.Valores opcionales: 720p, 1080p
​
aspect_ratio
string
predeterminado:"16:9"
Relación de aspecto del video de salida.Valores opcionales: 16:9, 9:16
​
sample_count
integer
predeterminado:1
Número de muestras de video a generar (1-4).Rango de valores: [1, 4]
​
enhance_prompt
boolean
predeterminado:true
Indica si se debe usar IA para reescribir el prompt y obtener mejores resultados de generación.
​
generate_audio
boolean
predeterminado:false
Indica si se debe generar audio al mismo tiempo.
​
negative_prompt
string
Describe el contenido que debe evitarse en el video generado.
​
reference_images
array
requerido
1-3 imágenes de referencia, usadas para guiar la generación de video. Cada elemento contiene una URL de imagen o datos codificados en Base64 y el tipo de referencia.Longitud del array: 1 - 3
​
person_generation
string
predeterminado:"allow_adult"
Indica si se permite generar personas adultas. allow_adult: permite generar adultos; dont_allow: no permite generar personas.Valores opcionales: allow_adult, dont_allow

​
Información de respuesta

​
task_id
string
Use task_id para solicitar la API de consulta del resultado de la tarea y recuperar la salida generada.