Skip to main content
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ápida
  • veo3.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 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
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 error
string
predeterminado:"16:9"
Proporción del videoValores disponibles:
  • 16:9 - Horizontal
  • 9:16 - Vertical
Predeterminado: 16:9
string
predeterminado:"720p"
Resolución del videoValores disponibles:
  • 720p - Resolución estándar
  • 1080p - Alta definición
  • 4K - Ultra alta definición
Predeterminado: 720p
string
URL de la imagen del primer fotograma para generación imagen-a-video
  • La URL de la imagen debe ser accesible públicamente sin protección anti-hotlink
  • Se recomiendan URLs de almacenamiento de objetos en lugar de enlaces de descarga temporales
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 fotograma
integer
Semilla aleatoria para reproducir los resultados de generaciónRango de valores: 0 - 4294967295
integer
predeterminado:"1"
Número de muestras a generar (1-4); actualmente se recomienda usar 1Predeterminado: 1
boolean
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 adultos
  • disallow - No permite generar personas o rostros
Predeterminado: allow_adult
string
predeterminado:"pad"
Estrategia de redimensionado de imagen (efectiva para imagen-a-video)Valores disponibles:
  • pad - Modo de relleno
  • crop - Modo de recorte
Predeterminado: pad
boolean
predeterminado:"true"
Si se habilita la mejora de prompt upstreamPredeterminado: true
  • Este parámetro solo puede establecerse en true. Establecerlo en false provocará un error en la solicitud
  • Si no necesita este parámetro, no lo incluya

Texto-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.