curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-custom-element",
  "model_params": {
    "element_name": "Mi personaje",
    "element_description": "Un joven personaje masculino con cabello corto, vistiendo una camiseta blanca",
    "reference_type": "image_refer",
    "element_image_list": {
      "frontal_image": "https://example.com/front.jpg",
      "refer_images": [
        {
          "image_url": "https://example.com/side.jpg"
        }
      ]
    }
  }
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-8dxnm6yz",
  "model": "kling-custom-element",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 600
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "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-custom-element",
    "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"
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream AI service unavailable",
    "type": "upstream_error"
  }
}

Kling

Kling Elemento personalizado

Kling Custom Element (kling-custom-element) crea elementos de sujeto reutilizables (personajes/objetos) a partir de imágenes o videos de referencia
Después de una creación exitosa, el element_id devuelto puede ser referenciado en la serie Kling O3 y Kling V3 Imagen-a-Video a través del parámetro element_list, permitiendo un control consistente de la apariencia del personaje
Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar estado
Al completarse la tarea, result_data contendrá el element_id para la generación de video

Notas importantes:

Este modelo se usa para crear sujetos reutilizables (elementos), no genera videos, no se necesitan parámetros prompt / duration / quality / aspect_ratio

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-custom-element",
  "model_params": {
    "element_name": "Mi personaje",
    "element_description": "Un joven personaje masculino con cabello corto, vistiendo una camiseta blanca",
    "reference_type": "image_refer",
    "element_image_list": {
      "frontal_image": "https://example.com/front.jpg",
      "refer_images": [
        {
          "image_url": "https://example.com/side.jpg"
        }
      ]
    }
  }
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-8dxnm6yz",
  "model": "kling-custom-element",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 600
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "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-custom-element",
    "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"
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream AI service unavailable",
    "type": "upstream_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-custom-element

requerido

Nombre del modelo

Opciones disponibles:

kling-custom-element

Ejemplo:

"kling-custom-element"

model_params

object

requerido

Parámetros 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 creación de elemento de sujeto enviada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757169743

string

ID de tarea

Ejemplo:

"task-unified-1757169743-8dxnm6yz"

model

string

Nombre del modelo real utilizado

Ejemplo:

"kling-custom-element"

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

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

video

Ejemplo:

"video"

usage

object

Información de uso y facturación

Show child attributes

Seedance 2.0 Mini Reference-to-Video Kling-O3 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 Elemento personalizado

Autorizaciones

Todas las APIs requieren autenticación Bearer Token

Cuerpo

Respuesta