Einführung
Kling 4.0 Flash Referenz zu Video erzeugt mit einem erforderlichen Prompt und bereitgestellten Referenzen eine neue 720p-Szene. Fügen Sie bis zu 10 Bilder und bis zu 5 Videoclips mit insgesamt 20 Sekunden hinzu. Benennen Sie Bilder als @Image1 und Videos als @Video1 und nummerieren Sie in Upload-Reihenfolge weiter.
Erklären Sie im Prompt den Beitrag jeder Referenz. Im Wüstenbeispiel legt ein Bild die Person fest, während zwei Videos die Kamerabewegung in einer Dämmerungsszene anleiten. Neue Clips sind 3–20 ganze Sekunden lang, standardmäßig 5 Sekunden, und enthalten synchronisierten Ton. Mit keep_original_audio lässt sich der Ton eines Referenzvideos beibehalten. Audiodateien als Referenz werden nicht unterstützt.
Wichtige Funktionen und Highlights
- Ordnen Sie im Prompt bis zu 10 Referenzbilder Personen, Objekten oder Szenendetails zu.
- Steuern Sie Bewegung und Bildausschnitt mit bis zu 5 Videos von insgesamt höchstens 20 Sekunden.
- Verknüpfen Sie die Szenenbeschreibung über @Image1 und @Video1 mit den bereitgestellten Dateien.
- Erzeugen Sie ein 3–20 Sekunden langes 720p-Ergebnis mit Ton oder behalten Sie den Referenzvideoton mit
keep_original_audiobei. - Übernehmen Sie das Eingabeformat mit auto oder wählen Sie 16:9, 9:16, 1:1 oder 21:9.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Erforderliche Szenenanweisungen ohne voreingestellten Text. Weisen Sie @Image1, @Image2, @Video1 und weiteren Uploads Rollen zu. mindestens 1 Zeichen |
reference_image_urls | Nein | Geben Sie bis zu 10 Bild-URLs an und benennen Sie sie in Upload-Reihenfolge als @Image1, @Image2 usw. Sie leiten die Szene an, ohne den Preis zu verändern. mindestens 1 Einträge · höchstens 10 Einträge |
reference_video_urls | Nein | Geben Sie bis zu 5 Video-URLs mit insgesamt 20 Sekunden an und benennen Sie sie als @Video1, @Video2 usw. mindestens 1 Einträge · höchstens 5 Einträge |
aspect_ratio | Nein | Wählen Sie auto, um den Referenzen zu folgen, oder legen Sie 16:9, 9:16, 1:1 oder 21:9 fest. Das Bildformat verändert weder den Sekundensatz noch verursacht es Zusatzkosten. |
keep_original_audio | Nein | Setzen Sie true, um den Referenzvideoton zu behalten, oder false für eine neu erzeugte Tonspur. Dies gilt bei Angabe eines Referenzvideos. Standardwert: |
duration_seconds | Nein | Die Ausgabelänge umfasst 3 bis 20 ganze Sekunden; der Standardwert beträgt 5 Sekunden. Über die berechnete Ausgabedauer beeinflusst sie den Gesamtbetrag. |
Preis
$0.113 / Sekunde
Generierung mit Referenzen wird pro Ausgabesekunde berechnet. Mit einem Referenzvideo gilt für die Ausgabedauer ein höherer Sekundensatz; die Länge der Referenzvideos wird nicht separat berechnet. Bildreferenzen, Promptformulierung, Seitenverhältnis und keep_original_audio kosten nicht zusätzlich. Von Klings Moderation abgelehnte Anfragen bleiben kostenfrei.
Anwendungsfälle
- Versetzen Sie eine Person aus einem Bild in eine Wüstenszene für Social Media, angeleitet von kurzen Bewegungsclips.
- Erkunden Sie eine Kombination aus Figur und Ort anhand separat benannter Bildreferenzen.
- Erstellen Sie für eine Inhaltsprüfung mehrere kurze Szenenentwürfe mit einer gewählten Kamerabewegung.
Prompt-Leitfaden und Praxistipps
- Erklären Sie zunächst die Rolle jedes Bildes, etwa „@Image1 liefert die Person“, und beschreiben Sie anschließend die neue Szene.
- Sagen Sie, was aus einem Video übernommen werden soll, etwa „verwenden Sie die langsame Kameraannäherung aus @Video1“, damit die Referenz einen bestimmten Zweck erfüllt.
- Beschreiben Sie den neuen Schauplatz, etwa „eine stille Wüste bei Dämmerung“, um die gewünschte Szene vom Referenzmaterial abzugrenzen.
- Halten Sie die Handlung für einen 3-Sekunden-Entwurf knapp, etwa „die reisende Person bleibt neben dem Schild stehen“.
- Ergänzen Sie bei einer neu generierten Tonspur eine Angabe wie „Ton: trockener Wind und ein ferner Zug“, um den enthaltenen Ton zu lenken.
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/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
