Saltar al contenido principal
POST
/
v3
/
async
/
veo-3.1-generate-img2video
Veo 3.1 imagen a video
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>"
}
La API de la versión Veo 3.1 Preview ya es compatible automáticamente con esta interfaz
Utilice el modelo de generación de video Veo 3.1 para generar contenido de video de alta calidad a partir de una imagen de entrada y una descripción de texto. Esta interfaz utiliza procesamiento asíncrono; debe consultar el resultado final generado mediante el task_id.

​
Encabezados de la solicitud

​
Content-Type
string
requerido
Valor enumerado: application/json
​
Authorization
string
requerido
Formato de autenticación Bearer: Bearer {{API Key}}.

​
Cuerpo de la solicitud

​
prompt
string
requerido
Cadena de texto que describe el video que desea generar.
​
image
string
Imagen de entrada; admite URL o codificación base64.
​
last_image
string
Imagen final, utilizada para completar el último fotograma del video. Admite URL o codificación base64.
​
reference_images
object[]
Lista de hasta tres imágenes asset o hasta una imagen style, utilizada para describir las imágenes de referencia que el modelo usará al generar el video.
​
aspect_ratio
string
Especifica la relación de aspecto del video generado.Valores enumerados: 16:9, 9:16. El valor predeterminado es 16:9.
​
duration_seconds
integer
Duración del archivo de video que desea generar (en segundos).Valores enumerados: 4, 6, 8; cuando se usa reference_images, solo puede ser 8.El valor predeterminado es 8.
​
enhance_prompt
boolean
Especifica si se debe usar Gemini para mejorar su prompt. Solo se admite true.Valor predeterminado: true
​
generate_audio
boolean
requerido
Especifica si se debe generar audio para el video.
​
negative_prompt
string
Cadena de texto que describe el contenido que desea impedir que el modelo genere.
​
person_generation
string
Configuración de seguridad que controla si se permite la generación de personas o rostros.Valores enumerados:
  • allow_adult (predeterminado): Solo permite generar adultos
  • dont_allow: No permite incluir personas ni rostros en la imagen
  • allow_all: Permite generar personas de todas las edades (requiere que el proyecto esté en la allowlist)
​
resolution
string
Resolución del video generado.Valores enumerados: 720p (predeterminado) o 1080p
​
sample_count
integer
Número de muestras de video que se generarán.Rango de valores: 1-4
​
seed
uint32
Número utilizado para inicializar el proceso de generación aleatoria. Usar la misma semilla, prompt y otros parámetros producirá el mismo video de salida, lo que hace que el proceso de generación sea determinista.Rango de valores: 0-4,294,967,295

​
Parámetros de información de la respuesta

​
task_id
string
requerido
El task_id de la tarea asíncrona. Debe usar este task_id para solicitar la API de consulta de resultado de tarea y obtener el resultado generado