Skip to main content
POST
Veo 3.1 imagen a video
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

string
requerido
Valor enumerado: application/json
string
requerido
Formato de autenticación Bearer: Bearer {{API Key}}.

Cuerpo de la solicitud

string
requerido
Cadena de texto que describe el video que desea generar.
string
Imagen de entrada; admite URL o codificación base64.
string
Imagen final, utilizada para completar el último fotograma del video. Admite URL o codificación base64.
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.
string
Especifica la relación de aspecto del video generado.Valores enumerados: 16:9, 9:16. El valor predeterminado es 16:9.
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.
boolean
Especifica si se debe usar Gemini para mejorar su prompt. Solo se admite true.Valor predeterminado: true
boolean
requerido
Especifica si se debe generar audio para el video.
string
Cadena de texto que describe el contenido que desea impedir que el modelo genere.
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)
string
Resolución del video generado.Valores enumerados: 720p (predeterminado) o 1080p
integer
Número de muestras de video que se generarán.Rango de valores: 1-4
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

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