# API di Kling 3.0 Motion Control

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

## Varianti del modello

Questa API supporta una variante del modello:

| Modello | ID | Descrizione |
|-------|-----|-------------|
| **Kling 3.0 Motion Control** | `kling-3.0-motion-control` | Generazione di video tramite un prompt testuale, un’immagine di riferimento e un video di riferimento |

## Kling 3.0 Motion Control

### Punto di accesso

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

### Parametri della richiesta

#### Obbligatori

| Parametro | Tipo | Descrizione |
|-----------|------|-------------|
| `model_name` | string | Deve essere `"kling-3.0-motion-control"` |
| `prompt` | string | Prompt per la generazione del video, fino a 5000 caratteri |
| `images` | string[] | Esattamente un URL di immagine di riferimento. Sono supportati `.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. Sono supportati `.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 corrisponde a quella del video sorgente. Il parametro `duration` non è supportato. Il rapporto d’aspetto dell’output è determinato dai contenuti multimediali di input 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 multimediali di esempio con quelli dei tuoi file che soddisfano i requisiti sopra indicati.

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

### Risposta iniziale

Restituisce un `task_id` per le interrogazioni periodiche:

```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 interrogazioni periodiche 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 del video in corso
- `succeed`: Generazione del video completata
- `failed`: Generazione del 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 cambi `character_orientation`, soprattutto quando selezioni `"image"`
3. **Audio originale**: Imposta `keep_original_sound` su `false` per disattivare il mantenimento dell’audio originale del video di riferimento; omettendo il parametro, l’audio viene mantenuto