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-video-edit",
  "prompt": "Haz que la iluminación sea más cálida y mantén todo lo demás sin cambios.",
  "video_urls": [
    "https://example.com/source.mp4"
  ],
  "quality": "auto",
  "duration": "auto",
  "aspect_ratio": "auto"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 5
  },
  "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-video-edit",
    "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 Edición de vídeo

Gemini Omni 1.2 Flash (gemini-omni-1.2-flash-video-edit) edita un vídeo mediante un prompt y referencias visuales opcionales.
Vídeo: video_urls requiere exactamente 1 vídeo de hasta 15 segundos.
Imágenes: Hasta 10 imágenes de referencia opcionales con image_urls.
Resolución: quality: 360p, 720p, 1080p, 4k o auto; auto por defecto conserva la entrada. Un valor concreto permite aumentar o reducir la resolución de salida.
Duración: duration solo admite auto, también predeterminado; sigue la entrada.
Relación de aspecto: aspect_ratio solo admite auto, también predeterminado; sigue la entrada.
Describe la edición con prompt; incluye allí las restricciones negativas. No hay un parámetro independiente de prompt negativo.
Audio nativo sincronizado automático, sin parámetros adicionales.
Fija seed para mejorar la reproducibilidad.
Procesamiento asíncrono: consulta el estado con el ID 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-video-edit",
  "prompt": "Haz que la iluminación sea más cálida y mantén todo lo demás sin cambios.",
  "video_urls": [
    "https://example.com/source.mp4"
  ],
  "quality": "auto",
  "duration": "auto",
  "aspect_ratio": "auto"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 5
  },
  "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-video-edit",
    "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.2-flash-video-edit

requerido

Nombre del modelo, fijo en gemini-omni-1.2-flash-video-edit

Opciones disponibles:

gemini-omni-1.2-flash-video-edit

Ejemplo:

"gemini-omni-1.2-flash-video-edit"

prompt

string

requerido

Instrucción que describe la edición deseada y lo que debe conservarse.

Admite chino e inglés. Describe claramente las acciones y los cambios para obtener resultados más estables. Escribe las restricciones negativas directamente en prompt, como No dialogue o Sin texto; no hay un parámetro independiente de prompt negativo.

El prompt es obligatorio y no puede estar vacío ni contener solo espacios en blanco.

Minimum string length: 1

Pattern: \S

Ejemplo:

"Haz que la iluminación sea más cálida y mantén todo lo demás sin cambios."

video_urls

string<uri>[]

requerido

Array de vídeos para editar; exactamente 1 vídeo. Solo URL HTTP/HTTPS de vídeo, formato mp4. Duración máxima de 15 segundos, sin mínimo; también se aceptan vídeos de 1–2 segundos.

Required array length: 1 element

Ejemplo:

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

image_urls

string<uri>[]

Array opcional de imágenes de referencia, hasta 10 imágenes, para restringir sujetos, estilo o elementos.

Requisitos de entrada:

Solo URL de imagen HTTP/HTTPS
Formatos admitidos: png, jpeg, webp

Facturación: Cada imagen de referencia aporta tokens de entrada.

Required array length: 1 - 10 elements

Ejemplo:

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

quality

enum<string>

predeterminado:auto

Resolución de salida; predeterminada auto.

360p: lado corto 360.
720p: lado corto 720.
1080p: lado corto 1080.
4k: lado corto 2160.
auto: conserva la resolución de entrada; valor predeterminado.

Elegir un valor concreto permite aumentar o reducir la resolución de salida.

Facturación: Los tokens de vídeo de salida aumentan con su resolución. El vídeo de entrada también aporta tokens; una resolución mayor cuesta más.

Opciones disponibles:

360p,

720p,

1080p,

4k,

auto

Ejemplo:

"auto"

duration

enum<string>

predeterminado:auto

Solo se permite auto y es el valor predeterminado; la duración sigue el vídeo de entrada.

Opciones disponibles:

auto

Ejemplo:

"auto"

aspect_ratio

enum<string>

predeterminado:auto

Solo se permite auto y es el valor predeterminado; la relación sigue el vídeo de entrada.

Opciones disponibles:

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-video-edit"

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 Edición de vídeo

Autorizaciones

Cuerpo

Respuesta