API de Kling 2.6 Motion Control

Referencia completa de la API de generación de vídeo con Kling 2.6 Motion Control de Kuaishou.

Variantes del modelo

Esta API admite una variante del modelo:

Kling 2.6 Motion Control

Punto de acceso

POST /api/v1/video/task

Parámetros de la solicitud

Obligatorios

Opcionales

La duración de salida sigue la del vídeo de origen. No se admite el parámetro duration. La relación de aspecto de salida se determina a partir de los medios de entrada y no se admite aspect_ratio. El proveedor de origen no ha especificado qué entrada determina la relación de aspecto de salida ni la regla exacta de selección.

La facturación se basa en la duración del vídeo de origen redondeada al segundo entero más cercano y en la resolución de salida seleccionada. Por ejemplo, 5,4 segundos se facturan como 5 segundos y 5,5 segundos como 6 segundos.

Ejemplo de solicitud

Sustituye las URL de los medios del ejemplo por las de tus propios archivos que cumplan los requisitos anteriores.

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-2.6-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Formato de respuesta

Respuesta inicial

Devuelve un task_id para realizar consultas periódicas:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Realiza consultas periódicas con GET /api/v1/video/{task_id} para comprobar el estado y obtener el vídeo generado.

Valores de estado

• submitted: Tarea aceptada y pendiente de procesamiento
• processing: Generación de vídeo en curso
• succeed: Generación de vídeo completada
• failed: Error en la generación de vídeo

Buenas prácticas

1. Medios de referencia: Proporciona exactamente una imagen y un vídeo, comprobando sus formatos, tamaños de archivo y dimensiones antes de enviarlos
2. Orientación: Vuelve a comprobar la duración del vídeo de referencia al cambiar character_orientation, especialmente al seleccionar "image"
3. Audio original: Establece keep_original_sound en false para no conservar el audio original del vídeo de referencia; si omites el parámetro, se conserva el audio