Einführung
Kling 4.0 Videobearbeitung verändert ein Video, das Sie schon haben, statt eines aus dem Nichts zu erzeugen. Laden Sie einen Clip von 3 bis 30 Sekunden hoch und schreiben Sie, was sich ändern soll: ein Motiv, den Schauplatz, das Wetter, die Tageszeit oder den Stil. Szene, Motiv und Bewegung bleiben so, wie sie gefilmt wurden. Sie können bis zu 10 Referenzbilder hinzufügen, um eine Person, ein Objekt oder einen Look einzubringen. Ergebnisse kommen in 720p oder 1080p mit Ton zurück.
Einen Kling-4.0-Modus nach dem Ausgangsmaterial wählen
| Was Sie am Anfang haben | Modus |
|---|---|
| eine geschriebene Szene oder ein Skript | Kling 4.0 Text zu Video |
| ein Startbild, optional mit Endbild und Zwischenbildern | Kling 4.0 Bild zu Video |
| Fotos, Clips oder Stimmproben, aus denen besetzt wird | Kling 4.0 Referenz zu Video |
| ein Clip, den Sie ändern möchten | Kling 4.0 Videobearbeitung (Sie sind hier) |
| ein Clip, den Sie fortsetzen möchten | Kling 4.0 Videoverlängerung |
Wichtige Funktionen und Highlights
Behält Szene und Bewegung
Das Modell folgt Ihrem Quellclip, daher bleiben Kamerafahrt, Pose und Timing erhalten. In unserem Test wurde ein Mann, der an einem Oldtimer-Cabrio an einer Wüsten-Tankstelle lehnt, in einen starken Schneefall verwandelt: Schnee legte sich auf Motorhaube und Dach, und seine Pose, die Straßenkarte, das Auto und die langsame Dolly-Fahrt passten alle zur Quelle.
Eine Person anhand eines Referenzbildes austauschen
Geben Sie ein Porträt als @Image1 an und sagen Sie, wen es ersetzt. In unserem Test wurde die Astronomin aus unserem Sternwarten-Clip zur Frau aus einem Referenzporträt – Haar, Gesicht und Cordjacke –, während ihre Hand am Rad, die Kopfdrehung und die Kranfahrt nach oben Bild für Bild gleich blieben.
Ihre Uploads im Prompt benennen
Nennen Sie den Clip @Video1 und die Referenzbilder @Image1, @Image2 usw. in der Reihenfolge, in der Sie sie hochgeladen haben. Sagen Sie, was welches ist, und beschreiben Sie dann die Änderung.
Ton kann bleiben oder neu sein
keep_original_audio ist standardmäßig aktiv und behält den eigenen Ton des Quellclips. Schalten Sie es aus, und das Modell erzeugt stattdessen neuen, synchronisierten Ton.
Länge folgt der Quelle oder Sie legen sie fest
Lassen Sie die Länge auf „Match source“ (Länge wie die Quelle), dann läuft das Ergebnis so lange wie Ihr Clip, auf die ganze Sekunde aufgerundet. Oder wählen Sie eine beliebige ganze Zahl von 3 bis 30 Sekunden.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Beschreiben Sie die Bearbeitung. Nennen Sie den Quellclip @Video1 und die Referenzbilder @Image1, @Image2 usw. mindestens 1 Zeichen |
video_url | Ja | Der zu bearbeitende Clip, MP4 oder WebM, 3 bis 30 Sekunden. Szene, Motiv und Bewegung bleiben erhalten. mindestens 1 Zeichen |
reference_image_urls | Nein | Optional, bis zu 10 Bilder einer Person, eines Objekts oder eines Stils zum Einbringen, je 10 MB. Benennen Sie sie als @Image1, @Image2 in der Reihenfolge des Uploads. mindestens 1 Einträge · höchstens 10 Einträge |
aspect_ratio | Nein | auto (Standard) folgt dem Quellclip; 16:9, 9:16, 1:1 oder 21:9 setzen Sie selbst. Ändert den Preis nicht. |
resolution | Nein | 720p (Standard) oder 1080p. 1080p kostet pro Sekunde mehr. |
keep_original_audio | Nein | Standardmäßig aktiv, dann bleibt der eigene Ton des Quellclips erhalten. Schalten Sie es aus, erzeugt das Modell neuen, synchronisierten Ton. Standardwert: |
duration_seconds | Nein | Länge des Ergebnisses: eine ganze Zahl von 3 bis 30 Sekunden oder -1 für „Match source“ (Standard), das dem Quellclip folgt, auf die ganze Sekunde aufgerundet. |
Preis
Berechnet pro Sekunde zum Bearbeitungssatz, auf die Output-Sekunden plus die Sekunden des Quellclips. Der Quellclip wird als mindestens so lang wie der Output gezählt, in ganzen Sekunden, bis zu 30 Sekunden. 1080p kostet pro Sekunde mehr als 720p. Referenzbilder und der Ton-Schalter ändern den Preis nicht. Eine abgelehnte oder fehlgeschlagene Anfrage wird nicht berechnet.
| Spezifikation | Preis |
|---|---|
| $0.1128 / Sekunde |
| $0.1692 / Sekunde |
Anwendungsfälle
Wetter oder Tageszeit ändern
Behalten Sie eine Einstellung, die Ihnen gefällt, und verwandeln Sie einen sonnigen Nachmittag in Schnee, Regen oder Dämmerung, ohne neu zu drehen.
Schauplatz oder Stil tauschen
Verlegen Sie dieselbe Darbietung an einen anderen Ort oder geben Sie einem Clip einen neuen Stil, während die Bewegung gleich bleibt.
Eine Person oder ein Objekt einbringen
Fügen Sie Referenzbilder hinzu, wenn die Bearbeitung etwas braucht, das die Quelle nie gezeigt hat, etwa eine bestimmte Jacke, ein Auto oder eine Figur.
Prompt-Leitfaden und Praxistipps
Sagen Sie, was gleich bleiben muss
Nennen Sie die Teile, die geschützt werden sollen: „Mann, seine Bewegungen und die Kamerafahrt bleiben so, wie sie sind“. Beschreiben Sie dann die Änderung. So macht das Modell nicht mehr neu, als Sie wollten.
Bei „Match source“ mit einem etwas längeren Clip rechnen
Mit der Länge auf „Match source“ entspricht das Ergebnis der Quelllänge, auf die ganze Sekunde aufgerundet, und das Modell führt die Bewegung für diesen letzten Bruchteil weiter. Ein 5,04 Sekunden langer Quellclip kam in unserem Test als 6,04 Sekunden langer Clip zurück. Der eigene Ton der Quelle endet einen Moment vor dem Bild.
Referenzen nur für das Neue verwenden
Referenzbilder sind für etwas gedacht, das der Clip noch nicht enthält. Bei einer Änderung wie Wetter oder Tageszeit reicht meist der Prompt allein.
Die 1080p-Wahl an die Aufgabe anpassen
Entwerfen Sie in 720p, um die Änderung zu prüfen, und rendern Sie in 1080p, sobald das Ergebnis stimmt. 1080p kostet pro Sekunde mehr.
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/4.0/video-edit",
"input": {
"aspect_ratio": "auto",
"duration_seconds": -1,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.
