curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v4-flash-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-v4-flash-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 31.96,
    "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-v4-flash-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-4.0-Flash

Kling-4.0-Flash Imagen a vídeo

Kling-4.0 Flash Image to Video (kling-v4-flash-image-to-video) genera vídeos a partir de imágenes
Solo admite el fotograma inicial; no admite fotogramas finales ni intermedios
La relación de aspecto la determina el primer fotograma, no acepta aspect_ratio
Solo admite 720p, con una duración de 3 a 20 segundos
Modo de procesamiento asíncrono, use el ID de tarea devuelto para consultar el estado
Los enlaces de vídeo generados son válidos durante 24 horas, guárdelos oportunamente

Cómo elegir entre Flash y Kling 4.0

Flash está diseñado para la creación frecuente y la iteración creativa rápida, con énfasis en la velocidad de generación y la eficiencia de costes para vídeos cortos en 720p. La siguiente comparación refleja las funciones que admite actualmente la API de EvoLink.

Característica	Kling 4.0 Flash	Kling 4.0
Resolución de salida	`720p`	`720p`, `1080p`
Duración de salida	`3`–`20` segundos	`3`–`30` segundos
Control de fotogramas	Solo fotograma inicial: `image_start`	Fotograma inicial, fotograma final opcional `image_end` y hasta `8` fotogramas intermedios en `keyframes`

Para controlar la transición entre los fotogramas inicial y final, utilizar fotogramas clave intermedios, generar en 1080p o superar los 20 segundos, utilice Kling 4.0 Imagen a vídeo. En Flash, envíe solo el fotograma inicial; no incluya image_end ni keyframes.

Flash utiliza identificadores de modelo propios. Al migrar, revise model, quality y duration. El coste real depende del precio vigente del modelo Flash seleccionado y de la liquidación final de la tarea.

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-v4-flash-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-v4-flash-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 31.96,
    "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-v4-flash-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-v4-flash-image-to-video

requerido

Nombre del modelo de generación de video

Opciones disponibles:

kling-v4-flash-image-to-video

Ejemplo:

"kling-v4-flash-image-to-video"

image_start

string<uri>

requerido

URL de imagen del primer fotograma para generación de imagen a vídeo (obligatorio)

Nota:

Tamaño de imagen: hasta 10MB
Formatos compatibles: .jpg, .jpeg, .png
Dimensiones de imagen: 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

Ejemplo:

"https://example.com/portrait.jpg"

prompt

string

requerido

Prompt de texto que describe el vídeo que se desea generar

Nota:

Máximo 2500 caracteres

Maximum string length: 2500

Ejemplo:

"The person in the image slowly turns their head and smiles"

duration

integer

predeterminado:5

Duración del vídeo en segundos. Valor predeterminado: 5 segundos

Rango:

Entero de 3 a 20

Rango requerido: 3 <= x <= 20

Ejemplo:

5

quality

enum<string>

predeterminado:720p

Nivel de resolución

Opciones:

Solo se admite 720p

Opciones disponibles:

720p

Ejemplo:

"720p"

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-v4-flash-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-4.0-Flash Imagen a vídeo

Cómo elegir entre Flash y Kling 4.0

Autorizaciones

Todas las APIs requieren autenticación Bearer Token

Cuerpo

Respuesta