Einführung
Kling 3.0 Motion Control nimmt ein klares Foto einer Figur (image_url) und einen Antriebs-Clip (video_url, 3 bis 30 Sekunden) und spielt dessen Bewegungen, Mimik und Handgesten auf dieser Figur nach, wobei Gesicht, Outfit und Umgebung aus dem Foto erhalten bleiben. Die Ausgabe ist exakt so lang wie der Antriebs-Clip und wird nach dieser Länge abgerechnet, nicht nach einer von Ihnen gewählten Dauer. prompt ist optional – nutzen Sie ihn für alles, was der Antriebs-Clip nicht zeigt, etwa die Umgebung oder den Look.
Einen Kling-3.0-Modus nach Ausgangsmaterial wählen
| Was Sie zu Beginn haben | Modus |
|---|---|
| eine geschriebene Szene oder ein Skript | Kling 3.0 Text zu Video |
| ein Startbild, optional mit Schlussbild | Kling 3.0 Bild zu Video |
| ein Figurfoto und ein Antriebs-Clip | Kling 3.0 Motion Control (Sie sind hier) |
Wichtige Funktionen und Highlights
Ein Foto, ein Antriebs-Clip, dieselbe Performance zweimal
Filmen oder lizenzieren Sie einen Antriebs-Clip – einen Tanz, einen Gang, eine Geste – und lassen Sie ihn über so viele Figurfotos laufen, wie Sie brauchen. In unserem Test kam dieselbe Choreografie desselben Antriebs-Clips Beat für Beat passend auf zwei verschiedenen Figuren zurück, jede mit ihrem eigenen Gesicht, ihrer Kleidung und ihrem Hintergrund.
Das Ergebnis läuft so lange wie der Antriebs-Clip
Es gibt kein Dauer-Feld zum Einstellen: Die Ausgabelänge entspricht immer dem Antriebs-Clip, von 3 bis 30 Sekunden, und die Abrechnung folgt derselben Länge.
720p oder 1080p
Motion Control geht nicht bis zu 4K. Die Auflösung ändert den Preis genauso wie bei den anderen Kling-3.0-Endpunkten.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Nein | Optional. Nutzen Sie ihn nur für das, was der Antriebs-Clip nicht zeigt – die Umgebung, den Look, alles Zusätzliche. höchstens 2500 Zeichen |
negative_prompt | Nein | Was nicht im Clip vorkommen soll – Objekte, Looks oder Bewegungen, die Sie nicht wollen –, bis zu 2.500 Zeichen. Optional; am Preis ändert es nichts. höchstens 2500 Zeichen |
image_url | Ja | Die zu animierende Figur: ein klares Ganz- oder Halbkörperfoto der Person. |
video_url | Ja | Antriebs-Clip, 3 bis 30 Sekunden: die zu übertragenden Bewegungen, Mimik und Gesten. Das Ergebnis ist so lang wie dieser Clip und wird nach dieser Länge abgerechnet. |
resolution | Nein | 720p oder 1080p. Die höhere Stufe kostet pro Sekunde mehr. |
keep_original_audio | Nein | Übernimmt den Originalton des Antriebs-Clips ins Ergebnis. Standardmäßig an. Standardwert: |
character_orientation | Nein | Wohin die Figur im Ergebnis blickt: video (Standard) folgt der Person im Antriebs-Clip, image folgt der Person auf Ihrem Foto. |
shot_type | Nein | Wie die Einstellungen geplant werden: customize (Standard) hält sich an Ihre Vorgaben, intelligent lässt das Modell die Einstellungen selbst planen. Am Preis ändert es nichts. |
Preis
Abrechnung nach der Länge des Antriebs-Clips (video_url), auf volle Sekunden aufgerundet, von 3 bis 30 Sekunden, nicht nach einer von Ihnen gesetzten Dauer. Die Auflösung ändert den Satz.
| Spezifikation | Preis |
|---|---|
| $0.1008 / Sekunde |
| $0.1344 / Sekunde |
Anwendungsfälle
Eine Performance über mehrere Figuren hinweg wiederverwenden
Choreografieren oder lizenzieren Sie einen einzigen Antriebs-Clip einmal, und wenden Sie ihn dann auf jedes Figurfoto einer Serie an – eine Tanzchoreografie, das Gestenset eines Produktpräsentators, eine wiederkehrende Begrüßung –, ohne die Bewegung jedes Mal neu zu drehen.
Einem statischen Figurfoto echte, gezielte Bewegung geben
Statt Bewegung in Worten zu beschreiben und auf eine bestimmte Geste zu hoffen, lässt Motion Control Sie die exakte Bewegung einmal als Antriebs-Clip zeigen und präzise anwenden.
Eine Performance an einen neuen Ort verlegen
Nutzen Sie den optionalen Prompt, um die Figur an einen anderen Ort zu setzen als den eigenen Hintergrund des Antriebs-Clips, während die Bewegung selbst identisch bleibt.
Prompt-Leitfaden und Praxistipps
Lassen Sie den Antriebs-Clip die Bewegung liefern
Der Prompt muss keine Bewegung beschreiben – der Antriebs-Clip liefert sie bereits. Nutzen Sie ihn nur für das, was der Clip nicht zeigt, etwa den Raum, ein Garderobendetail oder die Stimmung.
Halten Sie das Figurfoto klar und mit einem einzigen Motiv
Ein klares Ganz- oder Halbkörperfoto einer Person, gut beleuchtet und unverdeckt, gibt Motion Control die klarste Übereinstimmung. Ein Foto, auf dem die Figur teilweise verdeckt oder in einem ungewöhnlichen Winkel ist, lässt dem Modell mehr zum Raten.
Prüfen Sie, ob beide Eingaben breit genug sind
Sowohl das Figurfoto als auch der Antriebs-Clip brauchen etwa 720 Pixel oder mehr auf jeder Seite; ein Antriebs-Clip darunter wird abgelehnt, bevor der Auftrag startet – nicht erst, nachdem Sie dafür bezahlt haben.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/3.0/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
