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.1-flash-text-to-video",
  "prompt": "Una canica de cristal rueda por una pista y cae al agua.",
  "quality": "720p",
  "duration": 3,
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.1-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.1-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.1 Flash

Gemini Omni 1.1 Flash – Resumen de parámetros

Referencia completa de parámetros para los cinco modos de vídeo
Hay cinco modos: texto a vídeo, imagen a vídeo, referencia a vídeo, edición y extensión.
quality: Texto/Imagen/Referencia: cuatro niveles, predeterminada 720p. Edición/Extensión: además auto, predeterminada auto.
duration: Duración: generación 3–10; edición solo auto; extensión 3–10 segundos añadidos.
aspect_ratio: Relación predeterminada auto; edición y extensión solo aceptan auto.
El modelo genera automáticamente audio nativo sincronizado.
Escribe los requisitos negativos directamente en prompt.
Procesamiento asíncrono: consultar el estado de la tarea
Los enlaces generados son válidos durante 24 horas.

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.1-flash-text-to-video",
  "prompt": "Una canica de cristal rueda por una pista y cae al agua.",
  "quality": "720p",
  "duration": 3,
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.1-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.1-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

Elige el ID de modelo adecuado para la tarea y los medios de entrada:

gemini-omni-1.1-flash-text-to-video
gemini-omni-1.1-flash-image-to-video
gemini-omni-1.1-flash-reference-to-video
gemini-omni-1.1-flash-video-edit
gemini-omni-1.1-flash-video-extend

Opciones disponibles:

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

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

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

gemini-omni-1.1-flash-video-edit,

gemini-omni-1.1-flash-video-extend

Ejemplo:

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

prompt

string

requerido

Prompt para generación, edición o extensión.

Ejemplo:

"Una canica de cristal rueda por una pista y cae al agua."

image_urls

string<uri>[]

URLs de imágenes: 1–2 fotogramas para Imagen a vídeo; hasta 10 referencias; hasta 10 imágenes opcionales para edición y extensión.

Required array length: 1 - 10 elements

Ejemplo:

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

video_urls

string<uri>[]

Vídeos: hasta 3 referencias de 10 s; uno de 10 s para edición; uno de 30 s para extensión.

Required array length: 1 - 3 elements

Ejemplo:

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

quality

enum<string>

Resolución de vídeo

Valores admitidos:

360p: horizontal 640×360 / vertical 360×640
720p: horizontal 1280×720 / vertical 720×1280
1080p: horizontal 1920×1080 / vertical 1080×1920
4k: horizontal 3840×2160 / vertical 2160×3840
auto: solo para edición y extensión; sigue la resolución del vídeo de entrada

Valores predeterminados:

Texto/Imagen/Referencia: 720p
Edición/Extensión: auto

Facturación: La salida se factura por tokens de salida. En edición y extensión, los tokens del vídeo de entrada y salida se calculan con la resolución final de salida.

Opciones disponibles:

360p,

720p,

1080p,

4k,

auto

Ejemplo:

"720p"

duration

Duración del vídeo

Texto/Imagen/Referencia a vídeo: entero de 3 a 10 segundos; valor predeterminado 3
Edición de vídeo: solo se acepta auto; valor predeterminado auto; la duración sigue al vídeo de entrada
Extensión de vídeo: entero de 3 a 10 segundos; valor predeterminado 3; indica los segundos añadidos

Rango requerido: 3 <= x <= 10

Ejemplo:

3

aspect_ratio

enum<string>

predeterminado:auto

Relación predeterminada auto; edición y extensión solo aceptan auto.

Opciones disponibles:

16:9,

9:16,

auto

Ejemplo:

"auto"

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.1-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 devuelve 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.1 Flash – Resumen de parámetros

Autorizaciones

Cuerpo

Respuesta