VEO3
Generación de video VEO3 Oficial
- Modo de procesamiento asíncrono, devuelve un ID de tarea para consultas posteriores
- Admite texto-a-video e imagen-a-video (control de primer fotograma / primer y último fotograma)
- Admite resoluciones 720P y 1080P
- Admite duraciones de video de 4/6/8 segundos
- Admite generación de pista de audio
- Admite control de política de generación de personas
POST
Autorización
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala a la cabecera de la solicitud:
Parámetros de la solicitud
string
requerido
Nombre del modelo de generación de videoModelos disponibles:
veo3.1-fast-official- Veo 3.1 Oficial versión rápidaveo3.1-quality-official- Veo 3.1 Oficial versión de alta calidad
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
true: revisar los prompts y las imágenes de entrada conomni-moderation-latestfalseu omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Prompt positivo en textoDescriba escenas, acciones, estilos, etc. en detalle para obtener mejores resultados. Se recomiendan prompts en inglés.Ejemplo:
"a golden retriever running on the beach, sunset, cinematic"string
Prompt negativo para excluir contenido no deseadoEjemplo:
"blurry, low quality, watermark, text"integer
predeterminado:"8"
Duración del video en segundosValores recomendados:
4 / 6 / 8Predeterminado: 8Nota: Debe ser un número puro (por ejemplo, 8), no añada comillas, de lo contrario se producirá un errorstring
predeterminado:"16:9"
Proporción del videoValores disponibles:
16:9- Horizontal9:16- Vertical
16:9string
predeterminado:"720p"
Resolución del videoValores disponibles:
720p- Resolución estándar1080p- Alta definición4K- Ultra alta definición
720pstring
URL de la imagen del primer fotograma para generación imagen-a-video
string
URL de la imagen del último fotograma para generación imagen-a-videoSe usa junto con
first_frame_image para controlar el primer y el último fotogramainteger
Semilla aleatoria para reproducir los resultados de generaciónRango de valores:
0 - 4294967295integer
predeterminado:"1"
Número de muestras a generar (1-4); actualmente se recomienda usar
1Predeterminado: 1boolean
predeterminado:"false"
Si se debe generar pista de audio
string
predeterminado:"allow_adult"
Política de generación de personasValores disponibles:
allow_adult- Solo permite generar personas/rostros adultosdisallow- No permite generar personas o rostros
allow_adultstring
predeterminado:"pad"
Estrategia de redimensionado de imagen (efectiva para imagen-a-video)Valores disponibles:
pad- Modo de rellenocrop- Modo de recorte
padboolean
predeterminado:"true"
Si se habilita la mejora de prompt upstreamPredeterminado:
trueTexto-a-video vs Imagen-a-video
El sistema determina automáticamente el modo según si se proporcionan parámetros de imagen: sin imágenes para texto-a-video, con imágenes para imagen-a-video.Respuesta
integer
Código de estado de la respuesta, 200 en caso de éxito
array
Array de datos de la respuesta
Escenarios de uso
Escenario 1: Texto-a-video (básico)
Escenario 2: Texto-a-video (parámetros completos)
Escenario 3: Imagen-a-video (primer fotograma único)
Escenario 4: Imagen-a-video (primer fotograma + último fotograma)
Escenario 5: Video con audio
Consultar los resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un
task_id al enviarla. Use el endpoint Obtener estado de tarea para consultar el progreso y los resultados de la generación.