Einführung
Kling O3 Bild zu Video animiert Ihr eigenes Startbild. Laden Sie ein Bild hoch, fügen Sie optional ein Schlussbild hinzu, um das Ende festzulegen, und beschreiben Sie, was dazwischen passiert – das Prompt-Feld fasst bis zu 2.500 Zeichen. Wählen Sie eine Länge von 3 bis 15 ganzen Sekunden, eine Auflösung bis zu 4K und ob nativer Ton mit dem Bild erzeugt werden soll.
Einen Kling-O3-Modus nach Ausgangsmaterial wählen
| Was Sie zu Beginn haben | Modus |
|---|---|
| eine geschriebene Szene und sonst nichts | Kling O3 Text zu Video |
| ein abgenommenes Startbild | Kling O3 Bild zu Video |
| bis zu 7 Referenzfotos | Kling O3 Referenz zu Video |
| ein bereits vorhandenes Video | Kling O3 Videobearbeitung |
Wichtige Funktionen und Highlights
Das Startbild wird eng befolgt
Wer und was in Ihrem Bild zu sehen ist – die Personen, die Garderobe, der Raum – behält der Clip bei. In unserem Regenschirm-Beispiel stimmten die Gesichter der beiden Frauen über einen fünf Sekunden langen Clip hinweg mit dem Startbild überein; der Prompt musste nur die neue Handlung beschreiben.
Ein optionales Schlussbild legt das Ende fest
Fügen Sie last_image_url hinzu, und der Clip wird so aufgebaut, dass er auf diesem Bild landet, statt dort, wo das Modell sonst aufhören würde. Halten Sie beide Bilder in Licht, Blickwinkel und Bildausschnitt nah beieinander – ein großer Sprung zwischen ihnen lässt die Mitte eines langen Clips abdriften.
Ton, mit der Bewegung erzeugt
generate_audio fügt im selben Durchgang wie die Animation Dialog, Effekte und Umgebungsgeräusche hinzu, getimt auf die von Ihnen beschriebene Handlung, statt nachträglich in einem separaten Schritt ergänzt zu werden.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Beschreiben Sie nur, was nach dem Startbild passiert: die Handlung, die Kamerafahrt und, bei aktiviertem Ton, Dialog und Effekte. Wer und wo ist bereits durch das Bild festgelegt. mindestens 1 Zeichen · höchstens 2500 Zeichen |
image_url | Ja | Startbild. JPEG oder PNG. |
last_image_url | Nein | Optionales Schlussbild, auf dem der Clip enden soll. |
resolution | Nein | 720p, 1080p oder 4K. Höhere Stufen kosten pro Sekunde mehr. |
generate_audio | Nein | Fügt im selben Durchgang einen erzeugten Soundtrack hinzu – Dialog in Anführungszeichen, Effekte, Umgebungsgeräusche. Standardwert: |
duration_seconds | Nein | Ganze Sekunden, 3 bis 15. Bestimmt den Preis zusammen mit Auflösung und Ton. |
shot_type | Nein | single fragt nach einer durchgehenden Einstellung (Kling O3 kann trotzdem von allein schneiden; fügen Sie „one continuous shot, no cuts" hinzu, wenn es darauf ankommt). |
multi_prompt | Nein | Die Shot-Liste für |
Preis
Abrechnung pro Sekunde Ausgabe. Der Satz hängt von der Auflösung und davon ab, ob nativer Ton aktiviert ist.
| Auflösung | Audio erzeugen: Nein | Audio erzeugen: Ja |
|---|---|---|
| $0.0672 / Sekunde | $0.0896 / Sekunde |
| $0.0896 / Sekunde | $0.112 / Sekunde |
| $0.336 / Sekunde | $0.336 / Sekunde |
Anwendungsfälle
Ein bereits abgenommenes Bild animieren
Wenn genau die Personen, die Garderobe und die Komposition wichtig sind, erzeugen oder wählen Sie zuerst das Standbild und senden es dann hierher, statt diese Details einem Textprompt zu überlassen – der sie bei jedem Lauf neu zeichnet.
Zwei bereits vorhandene Bilder verbinden
Mit gesetztem image_url und last_image_url füllt der Clip einen glaubhaften Bewegungspfad zwischen einem abgenommenen Start- und Schlussbild – nützlich für eine Szene, die auf einer bestimmten finalen Komposition landen muss.
Dialog zu einem Standbild hinzufügen, das Ihnen bereits gefällt
Aktivieren Sie generate_audio und beschreiben Sie eine Dialogzeile zusammen mit der Handlung; das Bild liefert den Look, der Prompt liefert die Bewegung und die Worte.
Prompt-Leitfaden und Praxistipps
Beschreiben Sie das Danach, nicht das bereits Vorhandene
Beschreiben Sie nicht erneut, wer im Bild ist oder was er trägt – das Bild beantwortet das bereits. Verwenden Sie den Prompt für das, was sich ändert: die Handlung, die Kamerafahrt, den Ton.
Halten Sie ein Schlussbild nah am Startbild
Wenn Sie last_image_url verwenden, wählen oder erzeugen Sie ein Bild mit ähnlichem Licht und Bildausschnitt wie das Startbild. Eine nahe Übereinstimmung hält die Bewegung dazwischen glaubhaft; ein großer Sprung verlangt vom Modell, mehr zu erfinden, als es stabil halten kann.
Die Einstellung fixieren, wenn Kontinuität wichtig ist
shot_type single ist eine Präferenz, keine Garantie. Für eine Szene, die nicht geschnitten werden darf – etwa eine einzelne, ununterbrochene Reaktion –, fügen Sie „one continuous shot, no cuts" ans Ende des Prompts hinzu.
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/o3/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.












