Saltar al contenido principal
POST
/
v3
/
async
/
veo-3.0-generate-preview-img2video
Veo 3.0 Preview de imagen a video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.0-generate-preview-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image_url": "<string>",
  "image_base64": "<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>"
}
Utiliza el modelo de generación de video Veo 3.0 Preview para generar contenido de video de alta calidad a partir de una imagen de entrada y una descripción textual. Esta interfaz utiliza procesamiento asíncrono, por lo que debes consultar el resultado final generado mediante el task_id.

​
Encabezados de 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 deseas generar.
​
image_url
string
URL de la imagen de entrada. Debes proporcionar uno de estos dos parámetros: image_url o image_base64.
​
image_base64
string
Imagen de entrada codificada en Base64.
​
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 deseas generar (en segundos).Valores enumerados: 4, 6, 8. El valor predeterminado es 8.
​
enhance_prompt
boolean
Especifica si se debe usar Gemini para mejorar tu prompt.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 deseas 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 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, el mismo prompt y los demás parámetros produce 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 respuesta

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