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-preview",
  "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-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 26.66,
    "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-preview",
    "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 vídeo Preview

El modelo Grok Imagine 1.5 (grok-imagine-video-1.5-preview) admite texto a video, imagen a video y referencia a video 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 video, 1 = imagen a video (usada como primer fotograma), 2-7 = referencia a video
Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar
Los enlaces de video generados son válidos por 24 horas, guárdalos oportunamente

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-preview",
  "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-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 26.66,
    "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-preview",
    "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-preview

requerido

Nombre del modelo

Opciones disponibles:

grok-imagine-video-1.5-preview

Ejemplo:

"grok-imagine-video-1.5-preview"

prompt

string

requerido

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

Límite de longitud: no más de 4096 caracteres

Ejemplo:

"The person starts dancing"

image_urls

string<uri>[]

URL de las imágenes de entrada (opcional). El número de imágenes selecciona el modo de generación.

Selección de modo:

0 imágenes (omite el campo): texto a video, sin cargo por imagen
1 imagen: imagen a video, usada como primer fotograma
2-7 imágenes: referencia a video, combinadas entre sí

Requisitos:

Hasta 7 imágenes; 8 o más se rechazan
Tamaño de imagen: máx 10MB cada una
Formatos soportados: JPEG, PNG, WebP

Maximum array length: 7

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 video, por defecto 480p

Descripción:

480p: Resolución estándar, este es el valor predeterminado
720p: Alta resolución
1080p: Full HD

La generación con referencias (2-7 imágenes) admite hasta 720p. Enviar 1080p junto con 2 o más imágenes se rechaza. 1080p sigue disponible para texto a video y para imagen a video con una sola imagen.

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 video (0 imágenes) y referencia a video (2-7 imágenes). Con una sola imagen de entrada, la salida sigue las dimensiones de esa imagen y este parámetro se ignora.

Descripción:

auto: El modelo decide el encuadre, que puede variar entre ejecuciones; este es el valor predeterminado
16:9: Horizontal
9:16: Vertical
1:1: Cuadrado
3:2: Horizontal, formato fotográfico clásico
2:3: Vertical, formato fotográfico clásico

Opciones disponibles:

auto,

16:9,

9:16,

1:1,

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
Se envía después de la confirmación de facturación

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 caracteres

Mecanismo de Callback:

Tiempo de espera: 10 segundos
Máximo 3 reintentos en caso de fallo (después de 1/2/4 segundos)
El formato de respuesta coincide con 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-preview"

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 vídeo Preview

Autorizaciones

Cuerpo

Respuesta