curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v3-motion-control",
  "prompt": "A girl dancing gracefully",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/dance-reference.mp4"
  ],
  "quality": "720p",
  "model_params": {
    "character_orientation": "image"
  }
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v3-motion-control",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 408240,
    "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-v3-motion-control",
    "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-V3

Kling-V3 Control de movimiento

El modelo Kling-V3 Motion Control (kling-v3-motion-control) permite generar movimiento mediante imagen de referencia + video de referencia
El sistema extrae la trayectoria de movimiento del video de referencia y la aplica al personaje/objeto de la imagen de referencia, generando un nuevo video con movimientos consistentes con el video de referencia
La duración del video depende de character_orientation: image máximo 10 segundos, video máximo 30 segundos, mínimo 3 segundos
Modo de procesamiento asíncrono, utilice el ID de tarea devuelto para consultar el estado
El enlace del video generado es válido por 24 horas, por favor guárdelo lo antes posible

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-v3-motion-control",
  "prompt": "A girl dancing gracefully",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/dance-reference.mp4"
  ],
  "quality": "720p",
  "model_params": {
    "character_orientation": "image"
  }
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v3-motion-control",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 408240,
    "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-v3-motion-control",
    "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 interfaces requieren autenticación mediante Bearer Token##

Obtener API Key:

Visite la página de gestión de API Key para obtener su API Key

Agregue en el encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:kling-v3-motion-control

requerido

Nombre del modelo de generación de video

Opciones disponibles:

kling-v3-motion-control

Ejemplo:

"kling-v3-motion-control"

image_urls

string<uri>[]

requerido

Array de URLs de imágenes de referencia, utilizado para proporcionar la fuente de apariencia del personaje/objeto

Nota:

Envíe una imagen de referencia
Tamaño de imagen: no mayor a 10MB
Formatos de archivo compatibles: .jpg, .jpeg, .png
Dimensiones de imagen: ancho y alto ≥ 300px, relación de aspecto entre 1:2.5 ~ 2.5:1
La URL de la imagen debe ser accesible directamente por el servidor

Ejemplo:

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

video_urls

string<uri>[]

requerido

Array de URLs de video de referencia para proporcionar la trayectoria de movimiento

Nota:

Proporcione un video de referencia
Duración del video: 3 a 30 segundos
Tamaño del video: hasta 100MB
Dimensiones del video: ancho y alto entre 340px y 3850px
Evite cortes, movimientos rápidos y cambios de escena
La URL del video debe ser accesible directamente por el servidor

Ejemplo:

["https://example.com/dance-reference.mp4"]

model_params

object

requerido

Parámetros específicos del modelo (obligatorio), utilizado para la configuración del control de movimiento

Show child attributes

prompt

string

Texto de indicación (opcional), utilizado para guiar el contenido generado

Nota:

Máximo 2500 caracteres
Puede dejarse vacío, el modelo generará automáticamente basándose en la imagen y el video de referencia

Maximum string length: 2500

Ejemplo:

"A girl dancing gracefully"

quality

enum<string>

predeterminado:720p

Nivel de resolución

Descripción:

720p: Calidad estándar (std)
1080p: Calidad alta (pro)

Opciones disponibles:

720p,

1080p

Ejemplo:

"720p"

callback_url

string<uri>

Dirección de callback HTTPS cuando la tarea se complete

Momento del callback:

Se activa cuando la tarea se completa (completed), falla (failed) o se cancela (cancelled)
Se envía después de confirmar la facturación

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
Se prohíbe el callback a direcciones IP de red interna
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Máximo 3 reintentos después de un fallo
El formato del cuerpo de respuesta del callback es consistente con el formato devuelto por la interfaz de consulta de tareas
Si la dirección de callback devuelve un código de estado 2xx se considera exitoso, otros códigos de estado activarán reintentos

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 la tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

model

string

Nombre del modelo realmente utilizado

Ejemplo:

"kling-v3-motion-control"

object

enum<string>

Tipo específico de la 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

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

Kling-V3 imagen a video Kling-V3-Turbo texto a video

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-V3 Control de movimiento

Autorizaciones

Cuerpo

Respuesta