# 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:

| Modelo | ID | Descripción |
|-------|-----|-------------|
| **Kling 2.6 Motion Control** | `kling-2.6-motion-control` | Generación de vídeo mediante un prompt de texto, una imagen de referencia y un vídeo de referencia |

## Kling 2.6 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-2.6-motion-control"` |
| `prompt` | string | Prompt de generación de 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 3-10 segundos. `"video"`: sigue la orientación del personaje en el vídeo de referencia; el vídeo de referencia debe durar 3-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 conserva el audio original del vídeo de referencia. Acepta `true` o `false`; el valor predeterminado es `true` |

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.

```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-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:

```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 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