# API für Kling 3.0 Motion Control

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

## Modellvarianten

Diese API unterstützt eine Modellvariante:

| Modell | ID | Beschreibung |
|-------|-----|-------------|
| **Kling 3.0 Motion Control** | `kling-3.0-motion-control` | Videogenerierung mit einem Textprompt, einem Referenzbild und einem Referenzvideo |

## Kling 3.0 Motion Control

### Endpunkt

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

### Anfrageparameter

#### Erforderlich

| Parameter | Typ | Beschreibung |
|-----------|------|-------------|
| `model_name` | string | Muss `"kling-3.0-motion-control"` sein |
| `prompt` | string | Prompt zur Videogenerierung mit bis zu 5000 Zeichen |
| `images` | string[] | Genau eine URL eines Referenzbildes. 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 URL eines Referenzvideos. 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 beider Grenzwerte. Die Dauer muss mindestens 3 Sekunden betragen; das Maximum 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 Seitenverhältnis der Ausgabe wird durch die Eingabemedien bestimmt; `aspect_ratio` wird nicht unterstützt. Der vorgelagerte Anbieter hat weder angegeben, welche Eingabe das Seitenverhältnis der Ausgabe bestimmt, noch die genaue Auswahlregel offengelegt.

Die Abrechnung richtet sich nach der auf die nächste 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 Beispiel-URLs für Medien durch URLs Ihrer eigenen Dateien, die die oben genannten Anforderungen erfüllen.

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

## Antwortformat

### Erste Antwort

Gibt eine `task_id` für wiederholte Statusabfragen 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 den Status wiederholt mit `GET /api/v1/video/{task_id}` ab, um ihn 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**: Stellen Sie genau ein Bild und ein Video bereit und prüfen Sie vor dem Absenden deren Formate, Dateigrößen und Abmessungen
2. **Ausrichtung**: Prüfen Sie beim Wechsel von `character_orientation` erneut die Dauer des Referenzvideos, insbesondere bei Auswahl von `"image"`
3. **Originalton**: Setzen Sie `keep_original_sound` auf `false`, damit der Originalton des Referenzvideos nicht beibehalten wird; wenn Sie den Parameter weglassen, bleibt der Ton erhalten