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

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