Einführung
Kling 4.0 Flash Videobearbeitung beginnt mit einem vorhandenen Clip und einer erforderlichen Änderungsanweisung. Stellen Sie eine Quelle von 3–20 Sekunden und bei Bedarf bis zu 10 Referenzbilder bereit. Das 720p-Ergebnis erhält Szene, Motiv, Bewegung und Kamerafahrt der Quelle und setzt dabei die beschriebene Änderung um.
Die Ausgabedauer folgt der Quelle; Quellen über 20 Sekunden werden an dieser Stelle abgeschnitten. In unseren Tests blieb der Kleidungswechsel in der Sternwarte bei einer Quelldauer von 5,04 Sekunden auch im Ergebnis 5,04 Sekunden lang. Der Quellton bleibt standardmäßig erhalten. Setzen Sie keep_original_audio auf false, um neuen synchronisierten Ton zu erzeugen.
Wichtige Funktionen und Highlights
- Überarbeiten Sie die Bildgestaltung bei bestehendem Auftritt und bestehender Kamerafahrt.
- Ergänzen Sie bis zu 10 Referenzbilder, wenn die Änderung eine bestimmte visuelle Vorlage erfordert.
- Behalten Sie den zeitlichen Ablauf der Quelle im Ergebnis bei; das Quellmaterial ist auf 20 Sekunden begrenzt.
- Übernehmen Sie standardmäßig die ursprüngliche Tonspur oder lassen Sie neuen synchronisierten Ton generieren.
- Erhalten Sie die Ausgabe in 720p mit auto-Bildformat oder einem von vier unterstützten Seitenverhältnissen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Erforderliche Bearbeitungsanweisungen ohne voreingestellten Text. Beschreiben Sie die Änderung sowie die beizubehaltende Szene, das Motiv, die Bewegung und die Kamerafahrt. mindestens 1 Zeichen |
video_url | Ja | Erforderliche URL für einen einzelnen Quellclip mit 3–20 Sekunden; keine Quelle ist voreingestellt. Längere Eingaben werden bei 20 Sekunden abgeschnitten. mindestens 1 Zeichen |
reference_image_urls | Nein | Ergänzen Sie optional bis zu 10 Bild-URLs als Bearbeitungsreferenzen und benennen Sie diese in Upload-Reihenfolge als @Image1, @Image2 usw. mindestens 1 Einträge · höchstens 10 Einträge |
aspect_ratio | Nein | Mit auto folgt das Format dem Quellvideo. Alternativ legen Sie 16:9, 9:16, 1:1 oder 21:9 für die Ausgabe fest. |
keep_original_audio | Nein | Standardwert true behält den Quellton bei; false erzeugt eine neue synchronisierte Tonspur. Eine Änderung dieses Werts kostet nicht zusätzlich. Standardwert: |
Preis
$0.151 / Sekunde
Die Bearbeitung wird pro Quellsekunde berechnet, auf die nächste ganze Sekunde aufgerundet und auf 20 berechnete Sekunden begrenzt. Eine Quelle mit 5,04 Sekunden zählt als 6 berechnete Sekunden, selbst wenn die Ausgabe bei 5,04 Sekunden bleibt. Prompt, Referenzbilder, Seitenverhältnis und Tonwahl kosten nicht zusätzlich. Ablehnungen durch Klings Moderation werden nicht berechnet.
Anwendungsfälle
- Probieren Sie ein smaragdgrünes Abendkleid in einem Sternwarten-Clip aus und behalten Sie die Handlung bei.
- Prüfen Sie unterschiedliche Mantelfarben in Varianten einer kurzen Social-Szene.
- Erstellen Sie visuelle Entwurfsvarianten einer aufgenommenen Bewegung unter Beibehaltung der Quelltonspur.
Prompt-Leitfaden und Praxistipps
- Beginnen Sie mit den zu erhaltenden Elementen, etwa „Szene und Kamerabewegung beibehalten“, um die festen Bestandteile der Bearbeitung zu definieren.
- Benennen Sie eine gezielte Änderung wie „den Mantel anthrazitgrau färben“, bevor Sie mehrere Varianten anfordern.
- Weisen Sie jedem ergänzten Bild eine Rolle zu, etwa „die Jacke aus @Image1 verwenden“, damit die Referenz zur Änderung passt.
- Beschreiben Sie Material und Farbe zusammen, etwa „ein smaragdgrünes Samtkleid“, wenn die Kleidung geändert werden soll.
- Schalten Sie für eine neue Tonspur
keep_original_audioaus und ergänzen Sie eine Vorgabe wie „Ton: ein tiefes Motorbrummen und Abendwind“.
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-flash/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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.
