Skip to main content
POST

Autenticación

string
requerido
Todas las solicitudes requieren autenticación mediante Bearer Token.Obtener una API Key:Visite la página de gestión de API Keys para obtener su API Key.Añada el siguiente encabezado al realizar solicitudes:

Parámetros de la solicitud

string
requerido
Nombre del modelo de generación de video, fijado en gemini-omni-flash-preview.
string
requerido
Instrucción de texto. Para texto a video es la descripción de la escena; para imagen / video a video es la instrucción de acción / estilo / edición.
prompt y el material de referencia (image_urls / video_urls) deben proporcionarse al menos uno de ellos.
array<string>
Imágenes de referencia, máximo 16. Cada elemento es una URL http(s)://.Admite JPEG / PNG. Para varios sujetos (por ejemplo, «gato + ovillo de lana») puede enviar varias imágenes y describir en el prompt cómo interactúan.
array<string>
Video de referencia / a editar, máximo 1 (no se admite la referencia a varios videos). Puede ser un enlace directo http(s):// o data:video/....
  • El video de referencia debe durar de 1 a 24 segundos; la recomendación oficial es ≤3 segundos.
  • video_urls y extend_from_task_id son mutuamente excluyentes; proporcione solo uno de ellos, no ambos al mismo tiempo.
string
predeterminado:"16:9"
Relación de aspecto del video, que controla realmente la orientación de la imagen de salida.
Al proporcionar video_urls, el parámetro aspect_ratio no tendrá efecto.
Solo admite:
  • 16:9 - horizontal (predeterminado)
  • 9:16 - vertical
Otros valores se tratan como 16:9.
string
predeterminado:"720p"
Resolución del video. Actualmente solo admite 720p.
string
ID de la tarea anterior: introduzca el ** task_id** de la tarea de generación anterior.
extend_from_task_id y video_urls son mutuamente excluyentes; proporcione solo uno de ellos, no ambos al mismo tiempo.

Respuesta

integer
Código de estado de la respuesta. En caso de éxito es 200.
array
Array de tareas devuelto.

Consultar el resultado de la tarea

La generación de video es una tarea asíncrona. Tras el envío se devuelve un task_id. Use el endpoint Obtener estado de la tarea para consultar el progreso y el resultado de la generación.

Ejemplo de resultado exitoso

Casos de uso

Escenario 1: Texto a video

Escenario 2: Imagen a video

Escenario 3: Video a video