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

Referenzmedien: Stellen Sie genau ein Bild und ein Video bereit und prüfen Sie vor dem Absenden deren Formate, Dateigrößen und Abmessungen
Ausrichtung: Prüfen Sie beim Wechsel von character_orientation erneut die Dauer des Referenzvideos, insbesondere bei Auswahl von "image"
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