Einführung
Kling 3.0 Text zu Video verwandelt einen geschriebenen Prompt in einen Clip, ganz ohne Bild oder Antriebs-Video. Legen Sie eine Länge von 3 bis 15 ganzen Sekunden fest, eine Auflösung von 720p, 1080p oder 4K, und ein Seitenverhältnis von 16:9, 9:16 oder 1:1. Aktivieren Sie generate_audio, um Dialog, Effekte und Umgebungsgeräusche im selben Durchgang zu erzeugen, und wählen Sie shot_type, um bei einem durchgehenden Setup zu bleiben oder Kling seinen eigenen Multi-Shot-Schnitt wählen zu lassen.
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 (Sie sind hier) |
| ein Startbild, optional mit Schlussbild | Kling 3.0 Bild zu Video |
| ein Figurfoto und ein Antriebs-Clip | Kling 3.0 Motion Control |
Wichtige Funktionen und Highlights
Dialog und Umgebungsgeräusche in derselben Datei
Bei aktiviertem generate_audio kommt eine im Prompt in Anführungszeichen geschriebene gesprochene Zeile als hörbarer Dialog zurück, passend zum Bild getimt, zusammen mit jedem von Ihnen beschriebenen Umgebungsgeräusch. In unserem Test kam die Zeile „Don't wait up" über einem Streichquartett und dem Gemurmel einer Gala gesprochen zurück, alles aus einem Absatz.
Zwei Wege, mehrere Einstellungen zu handhaben
shot_type auf single gesetzt hält die Kamera die meiste Zeit bei einem Setup, kann aber trotzdem von allein schneiden – in unseren Tests bekamen zwei Einzeleinstellungs-Clips mittendrin einen zusätzlichen Schnitt, einmal mit einem Lichtwechsel dabei. Das Hinzufügen von „one continuous shot, no cuts" zum Prompt hielt die Einstellung in unserem erneuten Test zusammen. Setzen Sie shot_type auf multi, und Kling entscheidet stattdessen seine eigenen Schnitte.
720p, 1080p und 4K
Alle drei Auflösungen und der Audioschalter ändern den Preis. Entwerfen Sie Timing und Bildausschnitt bei 720p, und lassen Sie dann den Take, der Ihnen gefällt, in 4K laufen, sobald er den Render wert ist.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Beschreiben Sie das Motiv, die Handlung, die Kamera und, bei aktiviertem Ton, den Dialog und die Geräusche, die Sie möchten. mindestens 1 Zeichen · 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 |
aspect_ratio | Nein | 16:9, 9:16 oder 1:1. Für den ganzen Clip fest – es gibt kein Quellbild, dem stattdessen gefolgt werden könnte. |
resolution | Nein | 720p, 1080p oder 4K. Höhere Stufen kosten pro Sekunde mehr. |
generate_audio | Nein | Fügt demselben Clip einen erzeugten Soundtrack hinzu – Dialog in Anführungszeichen, Effekte, Umgebungsgeräusche. Standardwert: |
duration_seconds | Nein | Ganze Sekunden, 3 bis 15. Bestimmt den Preis. |
shot_type | Nein | single hält die Kamera die meiste Zeit bei einem Setup, kann aber trotzdem von allein schneiden; multi lässt Kling seinen eigenen Multi-Shot-Schnitt wählen. |
multi_prompt | Nein | Die Shot-Liste für |
guidance_scale | Nein | Wie eng sich der Clip an den Prompt hält, von 0 bis 1 (Standard 0,5). Höhere Werte folgen dem Wortlaut genauer, niedrigere lassen dem Modell mehr Freiheit. |
Preis
Abrechnung pro Sekunde Ausgabe. Auflösung und der Audioschalter ändern beide den Satz.
| Auflösung | Audio erzeugen: Nein | Audio erzeugen: Ja |
|---|---|---|
| $0.0672 / Sekunde | $0.1008 / Sekunde |
| $0.0896 / Sekunde | $0.1344 / Sekunde |
| $0.336 / Sekunde | $0.336 / Sekunde |
Anwendungsfälle
Eine Szene mit echtem Ton eröffnen
Ein Toast, ein Geständnis, ein Abschied – schreiben Sie die Zeile und aktivieren Sie Ton, und Dialog, Raumklang und Bild kommen in einer Datei an. Unser Dachterrassen-Party-Beispiel endet mit einer ganzen Gruppe, die gemeinsam eine Zeile ruft, getimt auf die klirrenden Flaschen und die Musik darunter.
Einen Look vor dem 4K-Render entwerfen
Text zu Video braucht kein Ausgangsbild, daher ist es der schnellste Weg, eine Lichtidee, eine Kamerafahrt oder eine Dialogzeile zu testen, bevor Sie einen 4K-Render dafür ausgeben.
An Bild zu Video für Kontinuität übergeben
Text zu Video entscheidet Garderobe, Gesicht und Bildausschnitt bei jedem Lauf neu. Wenn eine Figur über mehrere Clips hinweg gleich aussehen muss, erzeugen Sie die erste Einstellung hier und übernehmen dann deren letztes Bild als Startbild für Bild zu Video.
Prompt-Leitfaden und Praxistipps
Schreiben Sie es in der Reihenfolge, in der es passiert
Strukturieren Sie den Prompt als Motiv und Garderobe, Handlung, Kamerafahrt, Look, dann Ton. Das Beispiel „palazzo-terrace-gown" folgt dieser Reihenfolge: wer sie ist und was sie trägt, was sie tut (geht, dreht sich, spricht), die Kamera und das Licht, dann das Umgebungsgeräusch.
Geben Sie der ganzen Gruppe eine Zeile zum Landen
Wenn mehrere Personen im Bild sind, gibt das Benennen eines einzigen Moments – eine Zeile, gemeinsam gesprochen, ganz am Ende der Vorgabe – dem Modell einen klaren Beat, um den Dialog zu platzieren, statt zu raten, wann mehrere Stimmen sich überlappen sollten.
Sagen Sie „one continuous shot, no cuts", wenn es darauf ankommt
shot_type: single ist keine feste Garantie gegen Schnitte. Wenn die Einstellung durchgehend ein Setup halten muss, fügen Sie diese Anweisung direkt in den Prompt ein; sie hielt in unserem erneuten Test einer Einstellung, die beim ersten Versuch geschnitten und das Licht gewechselt hatte, sowohl Bildausschnitt als auch Beleuchtung stabil.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": false,
"duration_seconds": 5
}
}'
# 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.












