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-reference-to-video",
  "prompt": "Mantén la apariencia y el movimiento de cámara de las referencias.",
  "image_urls": [
    "https://example.com/character.png",
    "https://example.com/scene.png"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.1-flash-reference-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-reference-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 Referencia a vídeo

Genera vídeo con imágenes y vídeos de referencia
image_urls: URLs de imágenes de referencia. Obligatorio, máximo público 10. Solo HTTP/HTTPS.
video_urls: Vídeos de referencia opcionales, máximo 3 MP4 por HTTP/HTTPS, cada uno de hasta 10 segundos.
quality: Resolución: 360p, 720p, 1080p o 4k. Predeterminada: 720p.
duration: Duración en segundos: entero de 3 a 10, predeterminada 3.
aspect_ratio: Relación de aspecto: 16:9, 9:16 o auto; predeterminada 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-reference-to-video",
  "prompt": "Mantén la apariencia y el movimiento de cámara de las referencias.",
  "image_urls": [
    "https://example.com/character.png",
    "https://example.com/scene.png"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

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

predeterminado:gemini-omni-1.1-flash-reference-to-video

requerido

Nombre del modelo, fijo en gemini-omni-1.1-flash-reference-to-video

Opciones disponibles:

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

Ejemplo:

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

prompt

string

requerido

Prompt que describe el uso de las referencias de sujeto, estilo y movimiento.

Ejemplo:

"Mantén la apariencia y el movimiento de cámara de las referencias."

image_urls

string<uri>[]

requerido

Array de URL de imágenes de referencia. Obligatorio; de 1 a 10 imágenes para restringir sujetos, estilo o elementos.

Requisitos de entrada:

Solo URL de imagen HTTP/HTTPS
Formatos admitidos: 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 opcional de vídeos de referencia; máximo 3 vídeos.

Los vídeos pueden aportar referencias de movimiento, cámara o estilo y usarse junto con image_urls.

Requisitos de entrada:

Solo URL de vídeo HTTP/HTTPS
Formato: mp4
Cada vídeo debe durar como máximo 10 segundos

Facturación: Cada vídeo de referencia aporta tokens de entrada.

Required array length: 1 - 3 elements

Ejemplo:

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

quality

enum<string>

predeterminado:720p

Resolución de vídeo; valor predeterminado 720p.

Valores admitidos:

360p: horizontal 640×360 / vertical 360×640
720p: horizontal 1280×720 / vertical 720×1280; valor predeterminado
1080p: horizontal 1920×1080 / vertical 1080×1920
4k: horizontal 3840×2160 / vertical 2160×3840

La orientación depende de aspect_ratio: 16:9 produce horizontal y 9:16 vertical.

Facturación: Los tokens de salida aumentan linealmente con la resolución. Frente a 720p, 360p usa aproximadamente un tercio, 1080p alrededor de 1,5× y 4k alrededor de 3×. El cargo real depende del uso generado.

Opciones disponibles:

360p,

720p,

1080p,

4k

Ejemplo:

"720p"

duration

integer

predeterminado:3

Duración del vídeo en segundos; valor predeterminado 3.

Notas:

Acepta cualquier entero de 3 a 10
La duración afecta directamente a la facturación

Rango requerido: 3 <= x <= 10

Ejemplo:

3

aspect_ratio

enum<string>

predeterminado:auto

Relación de aspecto: 16:9, 9:16 o auto; predeterminada 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-reference-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 Referencia a vídeo

Autorizaciones

Cuerpo

Respuesta