curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-o3-image-to-video",
  "prompt": "The person in the image slowly turns their head and smiles",
  "image_start": "https://example.com/portrait.jpg",
  "duration": 5,
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-o3-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 9
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 7,
    "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: kling-o3-image-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"
  }
}

Kling-O3

Kling-O3 imagen a video

Kling-O3 Image to Video (kling-o3-image-to-video) genera videos basados en imágenes de entrada, impulsado por el modelo Kling AI kling-v3-omni
Soporta primer fotograma, último fotograma, imágenes de referencia, control de elementos, multi-toma y efectos de sonido
Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar estado
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": "kling-o3-image-to-video",
  "prompt": "The person in the image slowly turns their head and smiles",
  "image_start": "https://example.com/portrait.jpg",
  "duration": 5,
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-o3-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 9
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 7,
    "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: kling-o3-image-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 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:kling-o3-image-to-video

requerido

Nombre del modelo de generación de video

Opciones disponibles:

kling-o3-image-to-video

Ejemplo:

"kling-o3-image-to-video"

prompt

string

requerido

Prompt de texto. Obligatorio cuando multi_shot=false (por defecto), proporcionado por multi_prompt para cada toma cuando multi_shot=true

Nota:

Máximo 2500 caracteres
Use <<<element_1>>> para referenciar elementos, <<<image_1>>> para referenciar imágenes

Maximum string length: 2500

image_start

string<uri>

URL de imagen del primer fotograma

Requisitos de formato de imagen:

Formato: JPG / JPEG / PNG
Tamaño: <= 10MB
Dimensiones: ancho y alto >= 300px, relación de aspecto entre 1:2.5 y 2.5:1
La URL de la imagen debe ser accesible directamente por el servidor o activar una descarga directa al acceder

image_end

string<uri>

URL de imagen del último fotograma

Restricciones:

El último fotograma requiere un primer fotograma
El último fotograma no es compatible cuando el número total de imágenes supera 2
La URL de la imagen debe ser accesible directamente por el servidor o activar una descarga directa al acceder

image_urls

string<uri>[]

Array de URLs de imágenes de referencia (no primer/último fotograma, para referencia de estilo/escena/elemento)

Nota:

Las URL de las imágenes deben ser accesibles directamente por el servidor o activar una descarga directa al acceder

duration

integer

predeterminado:5

Duración del vídeo (segundos), entero en el rango 3-15

Rango requerido: 3 <= x <= 15

aspect_ratio

enum<string>

Relación de aspecto del vídeo

Opciones disponibles:

16:9,

9:16,

1:1

quality

enum<string>

Nivel de resolución

Opciones:

720p: Estándar 720P
1080p: Alta calidad 1080P
4k: Ultra alta definición 4K

Opciones disponibles:

720p,

1080p,

4k

sound

enum<string>

predeterminado:off

Control de efectos de sonido

Opciones disponibles:

on,

off

model_params

object

Parámetros de extensión del modelo

Show child attributes

callback_url

string<uri>

URL de callback HTTPS para completación de 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 protocolo HTTPS
Direcciones IP internas están prohibidas (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 después del fallo (a 1/2/4 segundos después del fallo)
El formato de respuesta del callback es consistente con la API de consulta de tareas
El código de estado 2xx se considera exitoso, otros códigos activan reintento

Ejemplo:

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

Respuesta

Tarea de generación 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:

"kling-o3-image-to-video"

object

enum<string>

Tipo de tarea

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

Detalles 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

Kling-O3 imagen a video

Autorizaciones

Todas las APIs requieren autenticación Bearer Token

Cuerpo

Respuesta