curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-omni-1.2-flash-text-to-video",
  "prompt": "Una canica de vidrio rueda rápidamente por una pista de madera y finalmente cae al agua salpicando.",
  "quality": "720p",
  "duration": 3,
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 3
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_token",
    "credits_reserved": 102.34,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gemini-omni-1.2-flash-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Gemini Omni 1.2 Flash

Gemini Omni 1.2 Flash – Resumen de parámetros

Gemini Omni 1.2 Flash ofrece seis tipos de tareas mediante POST /v1/videos/generations.
Texto a vídeo: gemini-omni-1.2-flash-text-to-video; solo requiere un prompt de texto; 3–15 segundos.
Imagen a vídeo: gemini-omni-1.2-flash-image-to-video; una imagen inicial (3–15 segundos) o imágenes inicial y final (3–10 segundos).
Referencias a vídeo: gemini-omni-1.2-flash-reference-to-video; imágenes y hasta 3 vídeos de referencia. Si duration supera 10 segundos, se permite como máximo 1 vídeo de referencia.
Edición: gemini-omni-1.2-flash-video-edit; 1 vídeo de hasta 15 segundos y, opcionalmente, hasta 10 imágenes de referencia. quality es auto por defecto.
Extensión: gemini-omni-1.2-flash-video-extend; 1 vídeo de hasta 30 segundos y, opcionalmente, hasta 10 imágenes de referencia. quality es auto por defecto; duration indica los segundos que se añaden.
Aumento de resolución: gemini-omni-1.2-flash-video-upscale; 1 vídeo de hasta 15 segundos con dimensiones estándar admitidas. La resolución de destino se define con quality; no necesita prompt.
Relación de aspecto: auto por defecto. Edición, extensión y aumento de resolución conservan la relación del vídeo de entrada.
Audio nativo sincronizado automático, sin interruptor adicional.
Fija seed para mejorar la reproducibilidad.
Procesamiento asíncrono: consulta el estado con el ID de tarea recibido.
Los enlaces duran 24 horas; guarda los resultados cuanto antes.

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-omni-1.2-flash-text-to-video",
  "prompt": "Una canica de vidrio rueda rápidamente por una pista de madera y finalmente cae al agua salpicando.",
  "quality": "720p",
  "duration": 3,
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 3
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_token",
    "credits_reserved": 102.34,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gemini-omni-1.2-flash-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

##Todas las APIs requieren autenticacion Bearer Token##

Obtener API Key:

Visita la Pagina de gestion de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

requerido

Nombre del modelo. Elige el ID según el material de entrada y la tarea:

gemini-omni-1.2-flash-text-to-video: texto a vídeo
gemini-omni-1.2-flash-image-to-video: imagen a vídeo (fotograma inicial o inicial y final)
gemini-omni-1.2-flash-reference-to-video: referencias a vídeo
gemini-omni-1.2-flash-video-edit: edición de vídeo
gemini-omni-1.2-flash-video-extend: extensión de vídeo
gemini-omni-1.2-flash-video-upscale: aumento de resolución de vídeo

Opciones disponibles:

gemini-omni-1.2-flash-text-to-video,

gemini-omni-1.2-flash-image-to-video,

gemini-omni-1.2-flash-reference-to-video,

gemini-omni-1.2-flash-video-edit,

gemini-omni-1.2-flash-video-extend,

gemini-omni-1.2-flash-video-upscale

Ejemplo:

"gemini-omni-1.2-flash-text-to-video"

prompt

string

Prompt de texto que describe el objetivo de generación, edición o continuación; admite chino e inglés. Obligatorio salvo para aumentar la resolución, que no requiere prompt.

Describe claramente el sujeto, la acción, la escena, el movimiento de cámara y los elementos que deben conservarse.
Escribe las restricciones negativas en el prompt, como No dialogue o Sin texto. No hay un parámetro independiente de prompt negativo.

El aumento de resolución de vídeo no utiliza prompt; cualquier prompt enviado se ignora.

Ejemplo:

"Una canica de vidrio rueda rápidamente por una pista de madera y finalmente cae al agua salpicando."

image_urls

string<uri>[]

Array de imágenes de entrada.

Imagen a vídeo: obligatorio, 1–2 imágenes. Una es el fotograma inicial; dos son el inicial y el final.
Referencias a vídeo: obligatorio; el máximo recomendado públicamente es de 10 imágenes.
Edición: opcional, hasta 10 imágenes de referencia.
Extensión: opcional, hasta 10 imágenes de referencia.
Texto a vídeo y aumento de resolución: no admiten imágenes de entrada.

Solo URL HTTP/HTTPS; formatos: png, jpeg, webp.

Required array length: 1 - 10 elements

Ejemplo:

[
  "https://example.com/character.png",
  "https://example.com/scene.png"
]

video_urls

string<uri>[]

Array de vídeos de entrada.

Referencias a vídeo: opcional; máximo recomendado públicamente de 3 vídeos. Si duration supera 10 segundos, como máximo 1.
Edición: exactamente 1 obligatorio, de hasta 15 segundos.
Extensión: exactamente 1 obligatorio, de hasta 30 segundos.
Aumento de resolución: exactamente 1 obligatorio, de hasta 15 segundos. Solo 640×360, 1280×720, 1920×1080 y sus equivalentes verticales.
Texto a vídeo e imagen a vídeo: no admiten vídeos de entrada.

Cada vídeo de referencia debe durar como máximo 10 segundos.

Required array length: 1 - 3 elements

Ejemplo:

["https://example.com/reference.mp4"]

quality

enum<string>

Resolución del vídeo.

Opciones (horizontal / vertical):

360p: 640×360 / 360×640
720p: 1280×720 / 720×1280
1080p: 1920×1080 / 1080×1920
4k: 3840×2160 / 2160×3840
auto: solo edición y extensión; conserva la resolución de entrada.

Valores predeterminados:

Texto a vídeo, imagen a vídeo y referencias a vídeo: 720p.
Edición y extensión: auto.
Aumento de resolución: destino obligatorio y superior a la entrada. 360p → 720p o 1080p; 720p → 1080p o 4k; 1080p → 4k.

Facturación: La generación de texto a vídeo, de imagen a vídeo y con referencias, la edición y la extensión se facturan por separado según los tokens de entrada, los tokens de vídeo de salida y los demás tokens de salida (incluidos los de razonamiento). El aumento de resolución solo cobra tokens de vídeo de salida, sin cargos por tokens de entrada ni de razonamiento. El importe al enviar la solicitud es una estimación; la facturación final se basa en el uso real.

Opciones disponibles:

360p,

720p,

1080p,

4k,

auto

Ejemplo:

"720p"

duration

Duración del vídeo.

Texto a vídeo y referencias a vídeo: enteros de 3 a 15 segundos; predeterminada 3.
Imagen a vídeo: 3–15 segundos con imagen inicial; 3–10 con inicial y final; predeterminada 3.
Edición y aumento de resolución: solo auto, también predeterminado. La duración sigue la entrada.
Extensión: enteros de 3 a 10 segundos; predeterminada 3; indica la duración que se añade.

Rango requerido: 3 <= x <= 15

Ejemplo:

3

aspect_ratio

enum<string>

predeterminado:auto

Relación de aspecto; predeterminada auto.

16:9: horizontal.
9:16: vertical.
auto: el modelo decide según el prompt y el material de entrada; valor predeterminado.

Edición, extensión y aumento de resolución solo admiten auto y conservan la relación de aspecto de entrada.

Opciones disponibles:

16:9,

9:16,

auto

Ejemplo:

"auto"

seed

integer

Semilla aleatoria; aleatoria por defecto. Rango: 0–4294967295. Fijar la semilla reduce la variación al ajustar los parámetros del prompt y mejora la reproducibilidad.

Rango requerido: 0 <= x <= 4294967295

Ejemplo:

42

callback_url

string<uri>

Direccion de callback HTTPS despues de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa (completed), falla (failed) o se cancela (cancelled)
Se envia despues de completar la confirmacion de facturacion

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
El callback a direcciones IP internas esta prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Maximo 3 reintentos en caso de fallo (reintentos despues de 1 segundo/2 segundos/4 segundos)
El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
La direccion de callback que devuelve un codigo de estado 2xx se considera exitosa, otros codigos de estado activaran reintentos

Ejemplo:

"https://your-domain.com/webhooks/video-task-completed"

Respuesta

Tarea de video creada exitosamente

created

integer

Marca de tiempo de creacion de la tarea

Ejemplo:

1757169743

string

ID de tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

model

string

Nombre del modelo real utilizado

Ejemplo:

"gemini-omni-1.2-flash-text-to-video"

object

enum<string>

Tipo de tarea especifico

Opciones disponibles:

video.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea. El endpoint de creación siempre devuelve processing; el estado interno pending también se presenta a los clientes como processing.

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"processing"

task_info

object

Informacion detallada de la tarea de video

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"video"

usage

object

Informacion de uso y facturacion

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Gemini Omni 1.2 Flash – Resumen de parámetros

Autorizaciones

Cuerpo

Respuesta