API de Kling 3.0 Motion Control

Referencia completa de la API para la generación de vídeos con Kling 3.0 Motion Control de Kuaishou.

Variantes del modelo

Esta API admite una variante del modelo:

Modelo	ID	Descripción
Kling 3.0 Motion Control	`kling-3.0-motion-control`	Generación de vídeos mediante una instrucción de texto, una imagen de referencia y un vídeo de referencia

Kling 3.0 Motion Control

Punto de acceso

POST /api/v1/video/task

Parámetros de la solicitud

Obligatorios

Parámetro	Tipo	Descripción
`model_name`	string	Debe ser `"kling-3.0-motion-control"`
`prompt`	string	Instrucción para la generación del vídeo, de hasta 5000 caracteres
`images`	string[]	Exactamente una URL de imagen de referencia. Admite `.jpg`, `.jpeg` y `.png`; el tamaño del archivo no debe superar los 50 MB. La anchura y la altura deben ser de al menos 300 px cada una, con una relación de aspecto de la imagen entre 1:2.5 y 2.5:1
`videos`	string[]	Exactamente una URL de vídeo de referencia. Admite `.mp4` y `.mov`; el tamaño del archivo no debe superar los 100 MB. La anchura y la altura deben estar entre 340 y 3850 px cada una, ambos inclusive. La duración debe ser de al menos 3 segundos; el máximo depende de `character_orientation`
`character_orientation`	string	Obligatorio, sin valor predeterminado. `"image"`: sigue la orientación del personaje en la imagen de referencia; el vídeo de referencia debe durar entre 3 y 10 segundos. `"video"`: sigue la orientación del personaje en el vídeo de referencia; el vídeo de referencia debe durar entre 3 y 30 segundos. Ambos intervalos de duración incluyen sus extremos
`resolution`	string	Resolución de salida: `"720p"` o `"1080p"`. Obligatorio, sin valor predeterminado

Opcionales

Parámetro	Tipo	Descripción
`keep_original_sound`	boolean	Indica si se debe conservar el audio original del vídeo de referencia. Acepta `true` o `false`; el valor predeterminado es `true`

La duración de la salida coincide con la del vídeo de origen. El parámetro duration no es compatible. La relación de aspecto de la salida viene determinada por los archivos multimedia de entrada, y aspect_ratio no es compatible. El proveedor de origen no ha especificado qué entrada determina la relación de aspecto de la 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 multimedia del ejemplo por las de tus propios archivos que cumplan los requisitos anteriores.

javascript
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-3.0-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:

json
{
  "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 en espera de procesamiento
processing: Generación del vídeo en curso
succeed: Generación del vídeo completada
failed: La generación del vídeo ha fallado

Prácticas recomendadas

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