curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-v2.6-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-v2.6-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": 22.68,
"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-v2.6-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-V2.6
Kling 2.6 Control de movimiento
- El modelo Kling 2.6 Motion Control (kling-v2.6-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:imagemáximo 10 segundos,videomá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
- Facturación: por segundo de vídeo de salida, redondeado al segundo entero más cercano;
1080pse factura a 1,6× la tarifa de720p - No admite elementos de sujeto (
element_list); las solicitudes con unelement_listno vacío se rechazan (una lista vacía se ignora). Usakling-v3-motion-controlsi necesitas elementos de sujeto
POST
/
v1
/
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-v2.6-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-v2.6-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": 22.68,
"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-v2.6-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
##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
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 entre1:2.5~2.5:1 - La URL de la imagen debe ser accesible directamente por el servidor
Ejemplo:
["https://example.com/character.jpg"]
Array de URLs de video de referencia para proporcionar la trayectoria de movimiento
Nota:
- Proporcione un video de referencia
- Duración del video:
3a30segundos - Formatos admitidos:
.mp4,.mov - Tamaño del video: hasta
100MB - Dimensiones del video: ancho y alto entre
340pxy3850px - 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"]
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
2048caracteres
Mecanismo de callback:
- Tiempo de espera:
10segundos - Máximo
3reintentos después de un fallo (con esperas de1/2/4segundos tras cada 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