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.Kling V3 Bewegungssteuerungs-API für referenzgesteuerte Charaktervideos
Greifen Sie über GoEnhance mit
API-Schlüssel abrufen
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.
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.
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 <code>https://api.goenhance.ai/api/v1/videos/generations</code> mit <code>model: kling-v3-motion</code>.
Prompt
Senden Sie einen erforderlichen <code>prompt</code> mit bis zu 2.500 Zeichen, um den Charakter, die Kleidung, die Szene oder die relevante Generierungsrichtung zu beschreiben.
Erscheinungseingabe
Eine <code>image_url</code> 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 <code>video_url</code> muss MP4 oder MOV sein, nicht größer als 100 MB, mit Abmessungen von 340 bis 3.850 px.
Orientierung und Länge
<code>character_orientation: video</code> akzeptiert 3–30 Sekunden; <code>image</code> akzeptiert 3–10 Sekunden. Der dokumentierte Standardwert ist <code>video</code>.
Auflösung und Audio
Wählen Sie 720p oder 1080p; es gibt keine 4K-Stufe. <code>generate_audio</code> 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 <code>video_url</code> 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 <code>duration</code>; 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.
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.