Kling V3 Bewegungssteuerungs-API für referenzgesteuerte Charaktervideos

Greifen Sie über GoEnhance mit model: kling-v3-motion auf Kling V3 Motion Control zu. Stellen Sie Erscheinungs- und Bewegungsreferenzen bereit, übermitteln Sie eine asynchrone Anfrage und verfolgen Sie die zurückgegebene img_uuid per Polling oder Callback.
API-Schlüssel abrufen
Filmische Bewegungsreferenz-Produktion für die Kling V3 Bewegungssteuerungs-API

Erscheinungs- und Bewegungsreferenzen in einer Anfrage kombinieren

Definieren Sie das Erscheinungsbild des Charakters

Verwenden Sie image_url für ein klares Oberkörper- oder Ganzkörperbild des Charakters oder nutzen Sie maximal ein Kling-Element über element_ids. Die Element-Eingabe erzwingt character_orientation: video.
Kontrollierte Erscheinungsreferenz-Fotografie für die Generierung von Charakter-Videos

Bewegung von einem Referenzvideo übertragen

Stellen Sie ein erforderliches MP4- oder MOV-Video in video_url bereit. Die Ausgabe folgt der nutzbaren kontinuierlichen Bewegung aus dieser Datei; dieser Endpunkt hat keinen duration-Parameter.
Choreografie-Probe einer einzelnen Szene als Bewegungsreferenz
Validieren Sie Medien vor der Übermittlung; nicht unterstützte Dauer- oder Auflösungswerte sollten clientseitig abgelehnt werden.

Funktionen und Validierungsregeln der Kling V3 Bewegungssteuerungs-API

Endpunkt und Modell

POST an https://api.goenhance.ai/api/v1/videos/generations mit model: kling-v3-motion.

Prompt

Senden Sie einen erforderlichen prompt mit bis zu 2.500 Zeichen, um den Charakter, die Kleidung, die Szene oder die relevante Generierungsrichtung zu beschreiben.

Erscheinungseingabe

Eine image_url kann JPG, JPEG oder PNG sein, bis zu 50 MB groß, mindestens 300 px pro Seite, mit einem Seitenverhältnis von 1:2,5 bis 2,5:1.

Bewegungseingabe

Die erforderliche video_url muss MP4 oder MOV sein, nicht größer als 100 MB, mit Abmessungen von 340 bis 3.850 px.

Orientierung und Länge

character_orientation: video akzeptiert 3–30 Sekunden; image akzeptiert 3–10 Sekunden. Der dokumentierte Standardwert ist video.

Auflösung und Audio

Wählen Sie 720p oder 1080p; es gibt keine 4K-Stufe. generate_audio behält den Originalton des Bewegungsvideos bei und ist standardmäßig auf false gesetzt.
Die Preisgestaltung erfolgt pro generierter Sekunde, während GoEnhance die Länge des Input-Bewegungsvideos als Obergrenze für die Gebühr der Anfrage misst.

Kling V3 Motion Control API-Preise

720p-Rate

6,3 Token pro generierter Sekunde, entsprechend $0.126/s bei den dokumentierten $0.02 pro Token.

1080p-Rate

8,4 Token pro generierter Sekunde, entsprechend $0.168/s bei den dokumentierten $0.02 pro Token.

Kostenschätzung

Schätzen Sie die Obergrenze der Anfragenkosten als die gemessene Dauer des Bewegungsvideos multipliziert mit der exakten Rate für die gewählte Auflösung.

Abrechnung nach gemessenem Input

GoEnhance überträgt und misst die video_url vor dem Abzug der Token, daher ändert eine Änderung der Remote-Datei nach der Messung nichts an der berechneten Input-Gebühr.

Output kann kürzer sein

Kling extrahiert nutzbare kontinuierliche Bewegungen; daher können schwierige oder sehr schnelle Bewegungen zu einem Output führen, der kürzer als das Referenzvideo ist.

Kein Dauer-Parameter

Senden Sie keine duration; der Endpunkt lehnt dies ab, und die Länge des Outputs richtet sich nach der aus dem Referenzvideo extrahierten nutzbaren Bewegung.

Integrieren Sie die Kling V3 Bewegungssteuerung in sechs Schritten

1

1. API-Schlüssel erstellen

Erstellen Sie einen GoEnhance API-Schlüssel und senden Sie ihn im Authorization-Header.
2

2. Beide Referenzen validieren

Überprüfen Sie die Bildschärfe und die Abmessungen und verifizieren Sie dann Format, Größe, Abmessungen und die von der Ausrichtung abhängige Länge des Bewegungsvideos.
3

3. Aufgabe übermitteln und persistieren

Senden Sie die Anfrage per POST mit model: kling-v3-motion und speichern Sie die zurückgegebene img_uuid, bevor Sie die Arbeit an einen Hintergrundprozessor übergeben.
4

4. Status verfolgen

Fragen Sie GET /api/v1/jobs/detail ab oder geben Sie eine öffentlich zugängliche HTTPS custom_callback_url an.
5

5. Callbacks idempotent behandeln

Behandeln Sie wiederholte Statusereignisse sicher. Ein Callback, der nicht HTTP 200 zurückgibt, kann bis zu dreimal mit einem Timeout von drei Sekunden pro Versuch wiederholt werden.
6

6. Endergebnis speichern

Trennen Sie die Verarbeitung, den Erfolg und die Fehlerbehandlung und speichern Sie die endgültige Video-URL erst, nachdem die Aufgabe einen Endzustand erreicht hat.
API-Schlüssel abrufen
Verwenden Sie Medien, für deren Verarbeitung Sie autorisiert sind, und konzipieren Sie für einen asynchronen Abschluss.

Anwendungsfälle für Entwickler zur Kling V3 Bewegungssteuerung

Charakter-Performance-Clips

Wenden Sie genehmigte Bewegungsreferenzen auf ein konsistentes Charakter-Erscheinungsbild für kurze narrative oder werbliche Video-Pipelines an.

Vorschauen für Tanz und Choreografie

Übertragen Sie lizenzierte Probenbewegungen in charaktergesteuerte Vorschauen, während Sie Zustimmungs- und Quell-Audio-Rechte wahren.

Animationskonzepte für Spielcharaktere

Generieren Sie Bewegungsstudien aus Charakter-Artworks und aufgezeichneten Bewegungen, bevor Sie sich auf einen vollständigen Animations-Workflow festlegen.

Lokalisierte Kampagnenvarianten

Parametrisieren Sie Prompts und Erscheinungsbild-Inputs für regionale kreative Varianten, während Sie eine Job-Orchestrierungsschicht wiederverwenden.

Workflows für virtuelle Darsteller

Erstellen Sie kontrollierte Darsteller-Pipelines rund um genehmigte Bildreferenzen, Bewegungs-Assets und Ausrichtungseinstellungen.

Previsualization

Testen Sie, ob eine Bewegungsreferenz für einen Charakter geeignet ist, bevor Sie mit der nachgelagerten Bearbeitung, dem Compositing und der Überprüfung fortfahren.
Antworten auf häufige Fragen zu Integration, Preisgestaltung, Validierung und der Kuaishou-API.

FAQ zur Kling V3 Bewegungssteuerungs-API

Was ist der Kling V3 Motion Control API-Endpunkt?

Übermitteln Sie über GoEnhance unter POST https://api.goenhance.ai/api/v1/videos/generations mit model: kling-v3-motion. Die Antwort gibt eine img_uuid zurück.

Wie funktioniert die Preisgestaltung der Kling V3 Bewegungssteuerungs-API?

720p kostet 6,3 Token/s ($0.126/s) und 1080p kostet 8,4 Token/s ($0.168/s). GoEnhance misst die Dauer des Bewegtbilds vor der Abbuchung als Obergrenze für die Gebühr der Anfrage.

Kann ich einen Dauer-Parameter senden?

Nein. Dieser Endpunkt lehnt duration ab. Das Referenzvideo muss die orientierungsspezifischen Grenzwerte erfüllen, und die Ausgabe folgt der nutzbaren kontinuierlichen Bewegung, die daraus extrahiert wurde.

Was ändert character_orientation?

video folgt der Blickrichtung im Bewegtvideo und erlaubt 3–30 Sekunden. image folgt dem Erscheinungsbild des Bildes und erlaubt 3–10 Sekunden.

Kann die API natives Audio generieren?

Nein. generate_audio behält nur den Original-Soundtrack des Bewegtvideos bei. Es ist standardmäßig auf „false“ gesetzt; verwenden Sie Audio nur, wenn Sie über die erforderlichen Rechte verfügen.

Kann ich ein Kling-Element anstelle eines Bildes verwenden?

Die V3-Route akzeptiert maximal einen Wert über element_ids (oder den Einzelwert-Alias element_id). Die Element-Eingabe erzwingt character_orientation: video.

Wie funktionieren Callbacks?

Geben Sie eine öffentliche HTTPS custom_callback_url an. Der Callback-Body entspricht der Antwort zum Job-Detail; Zustellungen, die nicht den Status 200 ergeben, können bis zu dreimal mit einem Timeout von drei Sekunden wiederholt werden.

Ist dies die offizielle API von Kuaishou?

Nein. Kling ist mit Kuaishou assoziiert, aber diese Seite beschreibt den unabhängigen Zugriff über GoEnhance. GoEnhance wird nicht als offizielle API, Partner oder Modellentwickler von Kuaishou oder Kling präsentiert.

Entwickeln mit der Kling V3 Bewegungssteuerungs-API