# Kling 2.6 Motion Control API

Vollständige API-Referenz für die Videogenerierung mit Kling 2.6 Motion Control von Kuaishou.

## Modellvarianten

Diese API unterstützt eine Modellvariante:

| Modell | ID | Beschreibung |
|-------|-----|-------------|
| **Kling 2.6 Motion Control** | `kling-2.6-motion-control` | Videogenerierung anhand eines Textprompts, eines Referenzbildes und eines Referenzvideos |

## Kling 2.6 Motion Control

### Endpunkt

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

### Anfrageparameter

#### Erforderlich

| Parameter | Typ | Beschreibung |
|-----------|------|-------------|
| `model_name` | string | Muss `"kling-2.6-motion-control"` sein |
| `prompt` | string | Prompt für die Videogenerierung, bis zu 5000 Zeichen |
| `images` | string[] | Genau eine Referenzbild-URL. Unterstützt `.jpg`, `.jpeg` und `.png`; die Dateigröße darf 50 MB nicht überschreiten. Breite und Höhe müssen jeweils mindestens 300 px betragen, bei einem Bildseitenverhältnis zwischen 1:2.5 und 2.5:1 |
| `videos` | string[] | Genau eine Referenzvideo-URL. Unterstützt `.mp4` und `.mov`; die Dateigröße darf 100 MB nicht überschreiten. Breite und Höhe müssen jeweils zwischen 340 und 3850 px liegen, einschließlich der Grenzwerte. Die Dauer muss mindestens 3 Sekunden betragen; die Höchstdauer hängt von `character_orientation` ab |
| `character_orientation` | string | Erforderlich, ohne Standardwert. `"image"`: folgt der Ausrichtung der Figur im Referenzbild; das Referenzvideo muss 3-10 Sekunden lang sein. `"video"`: folgt der Ausrichtung der Figur im Referenzvideo; das Referenzvideo muss 3-30 Sekunden lang sein. Beide Zeitspannen schließen ihre Grenzwerte ein |
| `resolution` | string | Ausgabeauflösung: `"720p"` oder `"1080p"`. Erforderlich, ohne Standardwert |

#### Optional

| Parameter | Typ | Beschreibung |
|-----------|------|-------------|
| `keep_original_sound` | boolean | Gibt an, ob der Originalton des Referenzvideos beibehalten wird. Akzeptiert `true` oder `false`; der Standardwert ist `true` |

Die Ausgabedauer entspricht der Dauer des Quellvideos. Der Parameter `duration` wird nicht unterstützt. Das Ausgabeseitenverhältnis wird durch die Eingabemedien bestimmt; `aspect_ratio` wird nicht unterstützt. Der vorgelagerte Anbieter hat weder angegeben, welche Eingabe das Ausgabeseitenverhältnis bestimmt, noch welche genaue Auswahlregel gilt.

Die Abrechnung basiert auf der auf die nächstgelegene ganze Sekunde gerundeten Dauer des Quellvideos und der gewählten Ausgabeauflösung. Beispielsweise werden 5,4 Sekunden als 5 Sekunden und 5,5 Sekunden als 6 Sekunden abgerechnet.

### Beispielanfrage

Ersetzen Sie die Medien-URLs im Beispiel durch die URLs Ihrer eigenen Dateien, die den oben genannten Anforderungen entsprechen.

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

## Antwortformat

### Erste Antwort

Gibt eine `task_id` für die regelmäßige Statusabfrage zurück:

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

Fragen Sie regelmäßig `GET /api/v1/video/{task_id}` ab, um den Status zu prüfen und das generierte Video abzurufen.

### Statuswerte

- `submitted`: Aufgabe angenommen und wartet auf Verarbeitung
- `processing`: Videogenerierung läuft
- `succeed`: Videogenerierung abgeschlossen
- `failed`: Videogenerierung fehlgeschlagen

## Bewährte Vorgehensweisen

1. **Referenzmedien**: Geben Sie genau ein Bild und ein Video an und prüfen Sie vor dem Absenden deren Formate, Dateigrößen und Abmessungen
2. **Ausrichtung**: Prüfen Sie die Dauer des Referenzvideos erneut, wenn Sie `character_orientation` ändern, insbesondere bei Auswahl von `"image"`
3. **Originalton**: Setzen Sie `keep_original_sound` auf `false`, um den Originalton des Referenzvideos nicht beizubehalten; wenn Sie den Parameter weglassen, bleibt der Ton erhalten