# API Kling 2.6 Motion Control

Riferimento API completo per la generazione video con Kling 2.6 Motion Control di Kuaishou.

## Varianti del modello

Questa API supporta una variante del modello:

| Modello | ID | Descrizione |
|-------|-----|-------------|
| **Kling 2.6 Motion Control** | `kling-2.6-motion-control` | Generazione video con un prompt testuale, un'immagine di riferimento e un video di riferimento |

## Kling 2.6 Motion Control

### Punto di accesso

```
POST /api/v1/video/task
```

### Parametri della richiesta

#### Obbligatori

| Parametro | Tipo | Descrizione |
|-----------|------|-------------|
| `model_name` | string | Deve essere `"kling-2.6-motion-control"` |
| `prompt` | string | Prompt per la generazione video, fino a 5000 caratteri |
| `images` | string[] | Esattamente un URL di immagine di riferimento. Supporta `.jpg`, `.jpeg` e `.png`; la dimensione del file non deve superare 50 MB. Larghezza e altezza devono essere entrambe di almeno 300 px, con un rapporto d'aspetto dell'immagine compreso tra 1:2.5 e 2.5:1 |
| `videos` | string[] | Esattamente un URL di video di riferimento. Supporta `.mp4` e `.mov`; la dimensione del file non deve superare 100 MB. Larghezza e altezza devono essere entrambe comprese tra 340 e 3850 px, estremi inclusi. La durata deve essere di almeno 3 secondi; il massimo dipende da `character_orientation` |
| `character_orientation` | string | Obbligatorio, senza valore predefinito. `"image"`: segue l'orientamento del personaggio nell'immagine di riferimento; il video di riferimento deve durare 3-10 secondi. `"video"`: segue l'orientamento del personaggio nel video di riferimento; il video di riferimento deve durare 3-30 secondi. Entrambi gli intervalli di durata includono gli estremi |
| `resolution` | string | Risoluzione di output: `"720p"` o `"1080p"`. Obbligatorio, senza valore predefinito |

#### Facoltativi

| Parametro | Tipo | Descrizione |
|-----------|------|-------------|
| `keep_original_sound` | boolean | Indica se mantenere l'audio originale del video di riferimento. Accetta `true` o `false`; il valore predefinito è `true` |

La durata dell'output segue quella del video sorgente. Il parametro `duration` non è supportato. Il rapporto d'aspetto dell'output è determinato dai contenuti multimediali in ingresso e `aspect_ratio` non è supportato. Il fornitore a monte non ha specificato quale input determini il rapporto d'aspetto dell'output né la regola esatta di selezione.

La fatturazione si basa sulla durata del video sorgente arrotondata al secondo intero più vicino e sulla risoluzione di output selezionata. Ad esempio, 5,4 secondi vengono fatturati come 5 secondi e 5,5 secondi come 6 secondi.

### Esempio di richiesta

Sostituisci gli URL dei contenuti multimediali di esempio con quelli dei tuoi file che soddisfano i requisiti indicati sopra.

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

### Risposta iniziale

Restituisce un `task_id` da usare per il polling:

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

Esegui il polling con `GET /api/v1/video/{task_id}` per verificare lo stato e recuperare il video generato.

### Valori di stato

- `submitted`: Attività accettata e in attesa di elaborazione
- `processing`: Generazione video in corso
- `succeed`: Generazione video completata
- `failed`: Generazione video non riuscita

## Buone pratiche

1. **Contenuti multimediali di riferimento**: Fornisci esattamente un'immagine e un video, verificandone formati, dimensioni dei file e dimensioni in pixel prima dell'invio
2. **Orientamento**: Ricontrolla la durata del video di riferimento quando modifichi `character_orientation`, soprattutto se selezioni `"image"`
3. **Audio originale**: Imposta `keep_original_sound` su `false` per non mantenere l'audio originale del video di riferimento; se ometti il parametro, l'audio viene mantenuto