Skip to main content
POST

Authentifizierung

string
erforderlich
Alle Anfragen erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel abrufen:Besuchen Sie die Seite zur API-Schlüsselverwaltung, um Ihren API-Schlüssel zu erhaltenFügen Sie jeder Anfrage den folgenden Header hinzu:

Anfrageparameter

string
erforderlich
Modellname: kling-v3-motion-control oder kling-v2-6-motion-control
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
Textprompt zur Beschreibung der gewünschten Bewegung, Kameraführung und StilrichtungOptional, aber empfohlen — konkretere Beschreibungen erzeugen stabilere ErgebnisseBeispiel: "The character dances following the reference video, smooth motion, realistic style"
string
erforderlich
URL des ReferenzbildesMuss ein öffentlich zugänglicher Link sein
string
erforderlich
URL des ReferenzvideosMuss ein öffentlich zugänglicher direkter Link sein; mp4/mov empfohlen, unter 100 MB
Der Server ermittelt die tatsächliche Dauer aus video_url. Das Minimum beträgt 3 Sekunden; das Maximum hängt von character_orientation ab.
string
Standard:"yes"
Ob die Original-Audiospur aus dem Referenzvideo beibehalten werden sollOptionen:
  • yes: Originalton behalten (Standard)
  • no: Originalton nicht behalten
string
erforderlich
Steuerung der CharakterausrichtungOptionen:
  • image: Charakterausrichtung aus dem Referenzbild verwenden (Dauer des Referenzvideos: 3~10s)
  • video: Charakterausrichtung aus dem Referenzvideo verwenden (Dauer des Referenzvideos: 3~30s)
string
erforderlich
GenerierungsmodusOptionen:
  • std: Standardmodus (ausgewogene Geschwindigkeit und Qualität)
  • pro: Modus für hohe Qualität (höhere Latenz)
object
Objekt zur Wasserzeichensteuerung (optional)

Dauer-Regeln

Die abrechnungsrelevante Dauer richtet sich nach der vom Server aus video_url ermittelten tatsächlichen Dauer und nicht nach einer clientseitigen Schätzung.

Antwort

integer
Statuscode der Antwort, 200 bei Erfolg
array
Datenarray der Antwort

Beispiele

Beispiel 1: Ausrichtung nach Bild (innerhalb von 10 s)

Beispiel 2: Ausrichtung nach Video (innerhalb von 30 s)