Wprowadzenie
Obraz na wideo w Kling 2.5 Turbo animuje klatkę początkową w klip 5 lub 10 sekund w 1080p, z prawdziwą ścieżką dźwiękową generowaną w tym samym przebiegu. Dodaj opcjonalną klatkę końcową (last_image_url), by ustalić zakończenie; proporcje wyjścia zależą od przesłanej klatki, wyłącznie JPEG lub PNG.
Wybierz tryb Kling 2.5 Turbo według materiału startowego
| Co masz na starcie | Tryb |
|---|---|
| pisaną scenę | Kling 2.5 Turbo – tekst na wideo |
| zatwierdzoną klatkę początkową | Kling 2.5 Turbo – obraz na wideo |
Najważniejsze funkcje
Opcjonalna klatka końcowa
last_image_url nie jest wymagane, ale gdy jest ustawione, klip zostaje zbudowany tak, by wylądować dokładnie w tej klatce, zamiast tam, gdzie model sam zdecyduje się zatrzymać. Nic nie ustala środka klipu, więc trzymaj obie klatki blisko siebie pod względem światła, pozy i kadrowania dla najgładszego rezultatu.
Dźwięk przychodzi razem z obrazem
Ścieżka dźwiękowa jest generowana w tym samym przebiegu co wideo – nie ma pola, by ją wyciszyć. Napisz w prompcie, jak scena powinna brzmieć, w tym samym miejscu, w którym opisujesz akcję.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Opisz tylko to, co dzieje się po klatce początkowej: akcję i ruch kamery. od 1 znaków · do 2500 znaków |
image_url | Tak | Klatka początkowa. Tylko JPEG lub PNG. |
last_image_url | Nie | Opcjonalna klatka końcowa. Gdy ustawiona, klip zostaje zbudowany tak, by w niej wylądować; środek nie jest inaczej ustalony. |
duration_seconds | Nie | Pełne sekundy, 5 lub 10. Determinuje cenę. |
negative_prompt | Nie | Krótka lista tego, czego klip powinien unikać. do 500 znaków |
guidance_scale | Nie | Od 0 do 1. Wyższa wartość trzyma się bliżej Twojego opisu; niższa daje modelowi więcej swobody. |
Cennik
$0.056 / sekunda
Rozliczane za sekundę wyjściowego klipu w 1080p. Przesłany plik odrzucony przez Kling nie jest rozliczany.
Zastosowania
Ożyw zatwierdzoną klatkę
Zacznij od nieruchomego obrazu, który już Ci się podoba – portret, zdjęcie produktu, concept art – i opisz tylko to, co dzieje się dalej; sama klatka się nie zmienia.
Połącz klatki w dłuższą scenę
Wyślij ostatnią klatkę jednego zatwierdzonego klipu jako klatkę początkową kolejnego i użyj last_image_url na tym nowym klipie, by wylądować w konkretnej pozie – przydatne przy łączeniu kilku klipów po 5 lub 10 sekund w jedną ciągłą scenę.
Wskazówki
Opisz tylko to, co się zmienia
Klatka początkowa ustala już podmiot, strój i scenerię – prompt musi tylko powiedzieć, co dzieje się dalej: akcję, ruch kamery i jak to brzmi.
Trzymaj obie klatki blisko siebie przy użyciu last_image_url
Klatka końcowa, która różni się mocno pozą, światłem lub kadrem od klatki początkowej, daje modelowi więcej pracy przy godzeniu przestrzeni pomiędzy nimi, a środek 10-sekundowego klipu może zacząć błądzić. Trzymaj obie klatki blisko siebie i pozwól, by ruch między nimi poniósł prompt.
Napisz dźwięk w tym samym zdaniu co ruch
Ponieważ dźwięk jest generowany razem z obrazem w każdym klipie, opisz, jak brzmi ruch, dokładnie tam, gdzie opisujesz sam ruch – kroki, tkaninę, wiatr, odległy zgiełk tłumu – zamiast traktować dźwięk jak dopisek na końcu promptu.
Szybki start z API
# 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.5-turbo/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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
