curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v4-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-video-edit",
  "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_second",
    "credits_reserved": 63.92,
    "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-video-edit",
    "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

Kling-4.0 Edición de vídeo

Kling-4.0 Video Edit (kling-v4-video-edit) edita un vídeo existente
El vídeo de salida conserva la relación de aspecto y el audio originales. Su duración coincide con la del original por defecto o puede establecerse con duration
Permite combinar instrucciones de texto e imágenes de referencia para la edición
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

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-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-video-edit",
  "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_second",
    "credits_reserved": 63.92,
    "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-video-edit",
    "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-video-edit

requerido

Nombre del modelo de generación de video

Opciones disponibles:

kling-v4-video-edit

Ejemplo:

"kling-v4-video-edit"

prompt

string

requerido

Instrucciones de edición de hasta 2500 caracteres

Sintaxis de referencia: Use <<<xxx>>> en el prompt para referirse a imágenes y vídeos, por ejemplo: Sustituir el abrigo de la persona en <<<video_1>>> por el estilo de <<<image_1>>>

Maximum string length: 2500

Ejemplo:

"Adjust the color to warm tones and add a cinematic feel"

video_urls

string<uri>[]

requerido

Lista de URL del vídeo que se va a editar. Solo admite 1 clip, referido como <<<video_1>>> en el prompt

Requisitos de vídeo:

Formatos: MP4 / MOV
Tamaño: ≤ 200MB
Duración: de 3 a 30 segundos
Dimensiones: ancho y alto entre 720px y 2160px
Frecuencia de fotogramas: de 24fps a 60fps
La URL del vídeo debe ser accesible directamente por el servidor

Required array length: 1 element

Ejemplo:

["https://example.com/original.mp4"]

image_urls

string<uri>[]

Lista de URL de imágenes de referencia de estilo

Límite: Hasta 10 imágenes Nota: Las URL deben ser accesibles directamente por el servidor o iniciar una descarga directa al acceder a ellas

Maximum array length: 10

Ejemplo:

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

duration

predeterminado:auto

Duración del vídeo de salida en segundos. Valor predeterminado: auto

Valores:

Entero: de 3 a 30 segundos
auto: Conservar la duración del vídeo original

Rango requerido: 3 <= x <= 30

Ejemplo:

"auto"

quality

enum<string>

predeterminado:720p

Nivel de resolución

Opciones:

720p: Estándar 720P
1080p: Alta calidad 1080P

Opciones disponibles:

720p,

1080p

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-video-edit"

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 Edición de vídeo

Autorizaciones

Todas las APIs requieren autenticación Bearer Token

Cuerpo

Respuesta