# 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

1. **Archivos multimedia 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 desactivar la conservación del audio original del vídeo de referencia; si omites el parámetro, se conserva el audio