Einführung
Kling 2.1 Master Bild zu Video animiert ein Startbild zu einem 5 oder 10 Sekunden langen Clip bei 1080p, ohne Audiotrack und ohne Schlussbild-Option bei diesem Endpunkt – nur image_url.
Einen Kling-2.1-Master-Modus nach Ausgangsmaterial wählen
| Was Sie zu Beginn haben | Modus |
|---|---|
| eine geschriebene Szene | Kling 2.1 Master Text zu Video |
| ein abgenommenes Startbild | Kling 2.1 Master Bild zu Video |
Wichtige Funktionen und Highlights
Das Bild bleibt stehen, der Prompt liefert die Bewegung
Garderobe, Pose, Licht und Umgebung des Startbilds bleiben genau so erhalten, wie sie gesendet wurden; der Prompt muss nur beschreiben, was als Nächstes passiert und wohin die Kamera geht. In unseren Tests kamen eine gefrorene Ozeanwelle und ein Unterwasser-Ballkleid beide überzeugend direkt aus einem einzelnen Standbild zum Leben, wobei Bildausschnitt und Kostüm unangetastet blieben.
Kein Endbild bei diesem Endpunkt
Anders als bei Kling 2.1s Standard-Bild-zu-Video nimmt das Bild-zu-Video von Master nur image_url entgegen, kein last_image_url. Wenn eine bestimmte Schlusspose wichtig ist, beschreiben Sie sie direkt im Prompt und lassen Sie das Modell darauf hinarbeiten, statt ein zweites Bild zu erwarten, das das Ende festlegt.
Bei Hochformat-Bildern kann das Gesicht kleiner wirken
Ist das Startbild ein Hochformat-Ausschnitt, folgt der Render diesem Format, und in einem unserer Tests wirkte das Gesicht dadurch kleiner und etwas weniger detailliert als bei einem Querformat-Bild. Ein engerer Gesichtsausschnitt im Hochformat-Startbild trägt mehr Detail in den fertigen Clip.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Beschreiben Sie nur, was nach dem Startbild passiert: die Handlung und die Kamerafahrt. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_url | Ja | Startbild. Nur JPEG oder PNG. |
duration_seconds | Nein | Ganze Sekunden, 5 oder 10. Bestimmt den Preis. |
negative_prompt | Nein | Eine kurze Liste dessen, was der Clip vermeiden soll – nützlich, um von häufigen Render-Fehlern bei komplexen Kamerafahrten wegzulenken. höchstens 500 Zeichen |
guidance_scale | Nein | 0 bis 1. Höher hält sich näher an Ihre Formulierung; niedriger gibt dem Modell mehr Freiheit. |
Preis
$0.216 / Sekunde
Abrechnung pro Sekunde des Ausgabeclips. Ein von Kling abgelehnter Upload wird nicht berechnet.
Anwendungsfälle
Ein bestimmtes Standbild zu seiner besten Qualität bringen
Nutzen Sie diese Stufe, wenn das Startbild bereits genau richtig ist - Licht, Garderobe, Pose - und der Render ein Behalten-Ergebnis sein soll statt ein Entwurf zum Vergleich mit günstigeren Takes.
Atmosphärische Bewegung: Stoff, Wasser, Feuer, Staub
Wallende Kleider, sich aufbäumende Wellen, treibender Nebel und ein schwingender Kronleuchter wirkten in unseren Tests allesamt natürlich, gerendert aus einem Standbild plus einem Prompt, der die Bewegung beschreibt - das passt zu jeder Einstellung, die auf Atmosphäre statt auf Dialog oder schnelle Handlung setzt.
Ein zweiter hochwertiger Clip im selben Projekt
Da sich dieser Endpunkt den höheren Preis von Master mit seinem Text-zu-Video-Pendant teilt, behandeln Sie ihn genauso: heben Sie ihn sich für eine Einstellung auf, die anderswo bereits abgenommen wurde, und klären Sie den Wortlaut zuerst auf einer günstigeren Stufe.
Prompt-Leitfaden und Praxistipps
Sagen Sie den Elementen des Standbilds, wann sie sich bewegen sollen
Verweisen Sie auf das, was bereits im Bild ist - eine Welle, eine Pose, ein Outfit - und beschreiben Sie die Reihenfolge, in der es zum Leben erwachen soll, statt die ganze Szene neu zu beschreiben; das Modell kennt das Bild bereits.
Kombinieren Sie negative_prompt mit einer kreisenden oder driftenden Kamera
Ein kurzer negative_prompt, der zum Beispiel verschwommene Gesichter oder verzerrte Hände benennt, ist eine günstige Möglichkeit, eine langsame Kreisfahrt oder eine Unterwasser-artige Drift von den häufigeren Render-Fehlern dieses Modells fernzuhalten, besonders sobald der Clip die vollen 10 Sekunden läuft.
Schneiden Sie das Gesicht bei Hochformat-Bildern etwas enger zu
Ist das Startbild ein Hochformat-Ausschnitt, wählen Sie einen engeren Gesichtsausschnitt als bei einer Querformat-Aufnahme; ein weiter Hochformat-Ausschnitt kann dazu führen, dass das Gesicht in Bewegung klein wirkt, wie es in einem unserer Hochformat-Tests der Fall war.
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/2.1-master/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"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.
