Einführung
Kling 2.1 Bild zu Video ist der einzige Modus, den diese Generation anbietet: Senden Sie ein Startbild und einen Prompt, der beschreibt, was als Nächstes passiert, wählen Sie eine resolution von 720p (Standard) oder 1080p (Pro), und erhalten Sie einen stummen 5 oder 10 Sekunden langen Clip zurück. Ein Schlussbild (last_image_url) wird nur bei 1080p akzeptiert.
Eine Auflösung nach Budget wählen
| Was Sie wollen | Auflösung |
|---|---|
| die günstigste Stufe in diesem Lineup | 720p (Standard) |
| ein schärferer Clip, mit optionalem Schlussbild | 1080p (Pro) |
Wichtige Funktionen und Highlights
Ein Endbild, aber nur bei 1080p
Setzen Sie resolution auf 1080p und fügen Sie neben Ihrem Startbild ein Endbild hinzu, dann wird der Clip so gebaut, dass er genau auf dieser Pose als letztem Bild landet. Bei 720p wird ein Endbild nicht akzeptiert: Eine Anfrage, die eines enthält, wird vor der Ausführung abgelehnt, ohne Berechnung - lassen Sie es auf dieser Stufe weg und lassen Sie den Clip vom Startbild aus laufen, bis dorthin, wo das Modell ihn enden lässt.
Kein Audiotrack auf beiden Stufen
Dieses Modell erzeugt auf 720p wie auf 1080p überhaupt keinen Ton. Das ist eine einfache Tatsache, mit der Sie planen sollten, kein Mangel - es passt zu Material, das für einen Schnitt bestimmt ist, der später eigene Stimme, Musik oder Sounddesign hinzufügt.
Start- und Endbild können sauber ineinander übergehen
In einem unserer Tests landete ein Spaziergang auf einem Steg, der im Nebel begann und auf einer nahen, kameragewandten Pose endete, fast exakt auf dem gelieferten Endbild, wobei Wind und Farbgebung über die vollen fünf Sekunden konsistent blieben.
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. |
last_image_url | Nein | Optionales Schlussbild, nur bei 1080p akzeptiert. Eine 720p-Anfrage, die es enthält, wird abgelehnt, ohne Berechnung. |
resolution | Nein | 720p (Standard, die günstigste Stufe) oder 1080p (Pro, und die einzige Stufe, die ein Schlussbild akzeptiert). |
duration_seconds | Nein | Ganze Sekunden, 5 oder 10. Bestimmt den Preis. |
negative_prompt | Nein | Eine kurze Liste dessen, was der Clip vermeiden soll. 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
Abrechnung pro Sekunde des Ausgabeclips; die 1080p-Pro-Stufe kostet pro Sekunde mehr als die 720p-Standardstufe. Ein von Kling abgelehnter Upload wird nicht berechnet.
| Spezifikation | Preis |
|---|---|
| $0.035 / Sekunde |
| $0.068 / Sekunde |
Anwendungsfälle
Der günstigste Test eines Startbilds
Führen Sie zuerst die 720p-Standardstufe aus, um zu sehen, ob eine Handlung, eine Kamerafahrt oder ein Bildausschnitt so wirkt, wie Sie es wollen, bevor Sie mehr für eine höhere Stufe oder eine neuere Generation ausgeben.
Eine Zweibild-Sequenz mit fixiertem Ende
Nutzen Sie die 1080p-Pro-Stufe mit sowohl image_url als auch last_image_url, wenn die genaue finale Pose wichtig ist – etwa die letzte Einstellung vor einem Schnitt.
Prompt-Leitfaden und Praxistipps
Beschreiben Sie eine durchgehende Handlung, von Anfang bis Ende
Das Schwertkampf-Beispiel oben benennt einen einzigen Bogen vom Schwung bis zur finalen Abwehrhaltung; diese Ein-Beat-Struktur ist bei dieser Generation zuverlässiger als mehrere unterschiedliche Handlungen in einem Prompt.
Erwarten Sie nicht, dass lange nachziehende Details ihre Form halten
Langes Haar, schleifender Stoff oder nachziehende Requisiten sind die Art von Detail, die diese Generation über 10 Sekunden hinweg leicht verliert - eine lange Samtschleppe wurde in einem unserer Treppentests sichtbar kürzer. Halten Sie solche Details kurz oder planen Sie einen Nachbearbeitungsschritt ein.
Wählen Sie die Auflösung passend zur Einstellung
Testen Sie zuerst mit 720p, solange Sie noch an Handlung oder Kamerafahrt feilen, und heben Sie sich die 1080p-Pro-Stufe - mit ihrem optionalen Endbild - für den Take auf, den Sie behalten möchten.
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/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",
"resolution": "720p"
}
}'
# 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.
