curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-video-1.5-lite",
  "prompt": "Una calle iluminada con neón por la noche, travelling lento hacia adelante bajo la lluvia",
  "duration": 6,
  "quality": "480p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "grok-imagine-video-1.5-lite",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 120,
    "video_duration": 6
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 5.712,
    "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: grok-imagine-video-1.5-lite",
    "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"
  }
}

Grok

Grok Imagine 1.5 Lite vídeo

Grok Imagine 1.5 Lite (grok-imagine-video-1.5-lite) es el nivel más económico de Grok Imagine 1.5: texto a vídeo e imagen a vídeo bajo un mismo nombre de modelo
No hay parámetro de modo: el número de elementos en image_urls selecciona el modo — 0 = texto a vídeo, 1 = imagen a vídeo (usada como primer fotograma). No se admiten imágenes de referencia (2 o más)
La salida 1080p se escala desde 720p y se factura a una tarifa por segundo más alta
Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar
Los enlaces de vídeo generados son válidos durante 24 horas, guárdalos 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": "grok-imagine-video-1.5-lite",
  "prompt": "Una calle iluminada con neón por la noche, travelling lento hacia adelante bajo la lluvia",
  "duration": 6,
  "quality": "480p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "grok-imagine-video-1.5-lite",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 120,
    "video_duration": 6
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 5.712,
    "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: grok-imagine-video-1.5-lite",
    "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 autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión 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:grok-imagine-video-1.5-lite

requerido

Nombre del modelo

Opciones disponibles:

grok-imagine-video-1.5-lite

Ejemplo:

"grok-imagine-video-1.5-lite"

prompt

string

requerido

Prompt de descripción del video (obligatorio, no puede estar vacío)

Límite de longitud de la plataforma EvoLink: no más de 2000 tokens (contados con el tokenizador cl100k; el texto CJK alcanza el límite con muchos menos caracteres que el latino). La plataforma también aplica un límite de 60000 bytes UTF-8.

Ejemplo:

"The person starts dancing"

image_urls

string<uri>[]

URL de la imagen de entrada (opcional). Una imagen cambia la petición a imagen a vídeo.

Selección de modo:

0 imágenes (omitir el campo): texto a vídeo, sin cargo por imagen
1 imagen: imagen a vídeo, usada como primer fotograma; las imágenes de entrada se facturan por separado (consulta la sección de precios)
2 o más imágenes se rechazan — la referencia a vídeo no se admite en Lite

Requisitos:

Cargas locales de Playground: hasta 10MiB (10485760 bytes) por imagen. El proveedor valida las URL de imágenes enviadas directamente a la API; no se les aplica esta comprobación de carga local.
Formatos admitidos: JPEG, PNG, WebP

Maximum array length: 1

Ejemplo:

["https://example.com/image.jpg"]

duration

integer

predeterminado:6

Duración del video (segundos), cualquier entero entre 1 y 15 segundos

Rango requerido: 1 <= x <= 15

Ejemplo:

6

quality

enum<string>

predeterminado:480p

Resolución del vídeo, por defecto 480p

Descripción:

480p: Resolución estándar, valor predeterminado
720p: Alta definición
1080p: Escalado desde 720p, facturado a una tarifa por segundo más alta

Consulta la sección de precios para las tarifas por resolución.

Opciones disponibles:

480p,

720p,

1080p

Ejemplo:

"480p"

aspect_ratio

enum<string>

predeterminado:auto

Relación de aspecto de salida, por defecto auto

Se aplica a: texto a vídeo (0 imágenes). Con una imagen de entrada la salida sigue las dimensiones de esa imagen y este parámetro se ignora.

Descripción:

auto: No se envía ninguna relación al proveedor; el canal upstream decide el encuadre (texto a vídeo genera actualmente 16:9); valor predeterminado
16:9: Horizontal
9:16: Vertical
1:1: Cuadrado
4:3: Horizontal, relación clásica de TV
3:4: Vertical, relación clásica de TV
3:2: Horizontal, relación clásica de foto
2:3: Vertical, relación clásica de foto

Opciones disponibles:

auto,

16:9,

9:16,

1:1,

4:3,

3:4,

3:2,

2:3

Ejemplo:

"16:9"

callback_url

string<uri>

URL de callback HTTPS tras completar la tarea

Momento del Callback:

Se activa cuando la tarea se completa, falla o se cancela

Restricciones de Seguridad:

Solo se soporta protocolo HTTPS
Callback a IPs internas 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 bytes UTF-8

Mecanismo de Callback:

Tiempo de espera: 10 segundos
Máximo 3 reintentos en caso de fallo (después de 1/2/4 segundos)
El cuerpo de la petición de callback utiliza la estructura de respuesta de la API de consulta de tareas
Código de estado 2xx = éxito, otros activan reintento

Ejemplo:

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

Respuesta

Tarea de video creada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757169743

string

ID de tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

model

string

Nombre del modelo real utilizado

Ejemplo:

"grok-imagine-video-1.5-lite"

object

enum<string>

Tipo de tarea específico

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

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Información 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

Información de uso y facturación

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

Grok Imagine 1.5 Lite vídeo

Autorizaciones

Cuerpo

Respuesta