Einführung
Kling 3.0 Bild zu Video nimmt ein Startbild (image_url) und einen Prompt, der beschreibt, was danach passiert, und liefert 3 bis 15 Sekunden bei 720p, 1080p oder 4K. Setzen Sie auch last_image_url, um ein Schlussbild zu fixieren, damit der Clip irgendwo Bestimmtes ankommt, statt nur irgendwo zu beginnen. Aktivieren Sie generate_audio für Dialog und Umgebungsgeräusche, die mit dem Bild erzeugt werden.
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 (Sie sind hier) |
| ein Figurfoto und ein Antriebs-Clip | Kling 3.0 Motion Control |
Wichtige Funktionen und Highlights
Ein Startbild und, wenn Sie es setzen, ein Schlussbild
Der Clip beginnt exakt bei Ihrem Bild, so wie es ist. Fügen Sie last_image_url hinzu, und Kling arbeitet auf dieses Bild hin statt auf ein offenes Ende – in unserem Test eines nebelverhangenen Steg-Spaziergangs stimmte das letzte Bild des Clips fast exakt mit dem Schlussbild überein, roter Schal inklusive.
Das Bild bestimmt den Look, der Prompt die Bewegung
Beschreiben Sie nur die Handlung, die Kamera und den Ton – nicht die Garderobe oder die Umgebung, die das Startbild bereits festlegt. Unser Beispiel „forecourt-lightning" beschreibt die Frau oder die Tankstelle aus dem Bild nie erneut; es fügt nur den Blitzeinschlag, ihren Gang in den Regen und den Donner hinzu.
Das Seitenverhältnis folgt dem Bild
Es gibt hier kein separates aspect_ratio-Feld: Die Ausgabe übernimmt das Format Ihres Startbilds, von einer breiten Landschaft bis zu einem hohen Porträtausschnitt.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Beschreiben Sie nur, was nach dem Startbild passiert – die Handlung, die Kamera und, bei aktiviertem Ton, den Ton. 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 |
image_url | Ja | Startbild. Der Clip beginnt bei diesem Bild und übernimmt dessen Seitenverhältnis. |
last_image_url | Nein | Optionales Schlussbild. Bei langen Clips kann die Mitte stärker abdriften, als die Enden fixiert bleiben. |
resolution | Nein | 720p, 1080p oder 4K. Höhere Stufen kosten pro Sekunde mehr. |
generate_audio | Nein | Fügt demselben Clip einen erzeugten Soundtrack hinzu. Bei 720p und 1080p kostet das pro Sekunde mehr als ein stummer Lauf; bei 4K ist der Preis mit und ohne Ton gleich. 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 Figur exakt wie entworfen fortsetzen
Wenn eine Person von einem Clip zum nächsten gleich aussehen muss, erzeugen oder wählen Sie zuerst ein Standbild und animieren es dann hier, statt einen neuen Text-zu-Video-Prompt zu schreiben, der Garderobe und Gesicht wieder dem Zufall überließe.
Einen Clip auf einem bestimmten Ende landen lassen
Setzen Sie ein Schlussbild, wenn der letzte Beat der Einstellung wichtig ist – ein gehaltener Ausdruck, eine Hand an einer Tür, eine Figur, die ins Bild geht –, statt das Ende dem Modell zu überlassen.
Ein Produkt- oder Modestandbild in Bewegung testen
Ein Standfoto eines Produkts oder eines Outfits, mit einem Prompt für eine einfache Kamerafahrt, reicht, um zu sehen, wie ein statisches Bild wirkt, sobald es sich bewegt und, bei aktiviertem Ton, klingt.
Prompt-Leitfaden und Praxistipps
Beschreiben Sie nur, was das Bild noch nicht zeigt
Unser Beispiel „forecourt-lightning" bleibt bei dem, was nach dem Standbild passiert: der Blitz, ihr Schritt vom Lastwagen, der Gang in den Regen. Es wiederholt nie ihr Outfit oder die Umgebung, die das Bild bereits festgelegt hat.
Die Einstellung fixieren, wenn Kontinuität wichtig ist
Über 15 Sekunden kann ein Detail im Hintergrund abdriften. Wenn ein bestimmtes Objekt oder Layout an Ort und Stelle bleiben muss, benennen Sie es direkt („derselbe rote Lastwagen bleibt die ganze Zeit hinter ihr geparkt"), statt anzunehmen, dass das Startbild es für den ganzen Clip fixiert.
Sagen Sie „one continuous shot, no cuts" für eine einzelne ungebrochene Einstellung
Unser Yacht-Reling-Beispiel schnitt beim ersten Versuch zu einem zweiten Winkel und wechselte von Dämmerung zu Tageslicht; das Hinzufügen dieser Zeile an den Anfang des Prompts, zusammen mit einer Beschreibung des gleichbleibenden Lichts, hielt beim erneuten Test sowohl Bildausschnitt als auch Farbe durch den ganzen Clip 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/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.
