Skip to main content
POST
Aviso de compatibilidad de nombres de modelo: Esta interfaz también admite los alias veo3.1-fast-ext (equivalente a veo3.1-fast), veo3.1-quality-ext (equivalente a veo3.1-quality) y veo3.1-lite-ext (equivalente a veo3.1-lite); cada alias y su modelo son intercambiables y producen los mismos resultados.

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
predeterminado:"veo3.1-fast"
requerido
Nombre del modelo de generación de videoModelos disponibles:
  • veo3.1-fast - Modelo de generación rápida, adecuado para previsualizaciones e iteraciones rápidas (alias compatible veo3.1-fast-ext)
  • veo3.1-quality - Modelo de generación de alta calidad, adecuado para la producción final (alias compatible veo3.1-quality-ext)
  • veo3.1-lite - Modelo de generación ligero, adecuado para generación por lotes de bajo coste (alias compatible veo3.1-lite-ext)
Ejemplo: "veo3.1-fast"
Para mantener la compatibilidad con llamadas anteriores, los alias veo3.1-fast-ext (corresponde a veo3.1-fast), veo3.1-quality-ext (corresponde a veo3.1-quality) y veo3.1-lite-ext (corresponde a veo3.1-lite) siguen estando disponibles.
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 con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Descripción textual para la generación de video
integer
Duración del video en segundosValor fijo: 8 (VEO3 solo admite duración de 8 segundos)
string
Proporción del videoFormatos admitidos:
  • 16:9 (Horizontal)
  • 9:16 (Vertical)
string
Tipo de generación de videoTipos admitidos:
  • frame - Fotograma-a-video (modo FL)
  • reference - Imagen-de-referencia-a-video
Si no se especifica, se determina según el número de imágenes: 2 imágenes para fotograma-a-video, 3 imágenes para imagen-de-referencia-a-videoNota: El modelo veo3.1-quality no admite el modo reference
El modelo veo3.1-lite no admite este parámetro, no lo envíe
array<url>
Array de URLs de imagen de referencia para generación imagen-a-videoAdmite URLs de imagen accesibles públicamente (http:// o https://)Ejemplo: ["https://example.com/image.jpg"]Limitaciones:
  • Máximo de 3 imágenes
  • Para el modo fotograma-a-video: la primera imagen es el fotograma inicial, la segunda imagen es el fotograma final
  • Tamaño máximo del archivo: 10MB
  • Formatos admitidos: .jpeg, .jpg, .png, .webp
El modelo veo3.1-lite no admite este parámetro, no lo envíe
string
Resolución del videoValores admitidos:
  • 720p (Predeterminado)
  • 1080p
  • 4k
boolean
Habilitar el formato de salida GIF. Predeterminado: falseNota: GIF y resolución 1080p/4k no se pueden usar simultáneamente
boolean
predeterminado:"false"
Si se usa el canal oficial como respaldo
  • false: No usar (predeterminado)
  • true: Usar canal oficial
El modelo veo3.1-lite no admite este parámetro, no lo envíe

Respuesta

integer
Código de estado de la respuesta
array
Array de datos de la respuesta