Wprowadzenie
Obraz na wideo w Kling 2.1 to jedyny tryb oferowany przez tę generację: wyślij klatkę początkową i prompt opisujący, co dzieje się dalej, wybierz resolution 720p (standard) lub 1080p (pro), i odbierz cichy klip 5 lub 10 sekund. Klatka końcowa (last_image_url) jest akceptowana tylko w 1080p.
Wybierz rozdzielczość według budżetu
| Czego potrzebujesz | Rozdzielczość |
|---|---|
| najtańszy poziom w tej linii | 720p (standard) |
| ostrzejszy klip, z opcjonalną klatką końcową | 1080p (pro) |
Najważniejsze funkcje
Klatka końcowa, ale tylko w 1080p
Ustaw resolution na 1080p i dodaj klatkę końcową obok klatki początkowej, a klip zostanie zbudowany tak, by na ostatniej klatce wylądować dokładnie w tej pozie. W 720p klatka końcowa nie jest akceptowana: żądanie, które ją zawiera, jest odrzucane przed uruchomieniem, bez naliczania opłaty, więc pomiń ją na tym poziomie i pozwól, by klip biegł od klatki początkowej aż tam, gdzie model postanowi się zatrzymać.
Brak ścieżki dźwiękowej na obu poziomach
Ten model nie generuje w ogóle dźwięku, ani w 720p, ani w 1080p. To zwykły fakt, z którym trzeba się liczyć, a nie wada – pasuje do materiału trafiającego do montażu, który później sam doda narrację, muzykę lub udźwiękowienie.
Klatka początkowa i końcowa mogą połączyć się gładko
W jednym z naszych testów spacer po molo, który zaczynał się we mgle, a kończył bliską pozą zwróconą do kamery, wylądował niemal dokładnie na dostarczonej klatce końcowej, przy spójnym wietrze i korekcji kolorów przez wszystkie pięć sekund.
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 5000 znaków |
image_url | Tak | Klatka początkowa. Tylko JPEG lub PNG. |
last_image_url | Nie | Opcjonalna klatka końcowa, akceptowana tylko w 1080p. Żądanie w 720p, które ją zawiera, jest odrzucane, bez naliczania opłaty. |
resolution | Nie | 720p (standard, najtańszy poziom) lub 1080p (pro, jedyny poziom akceptujący klatkę końcową). |
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
Rozliczane za sekundę wyjściowego klipu; poziom 1080p pro kosztuje więcej za sekundę niż poziom standard 720p. Przesłany plik odrzucony przez Kling nie jest rozliczany.
| Specyfikacja | Cena |
|---|---|
| $0.035 / sekundę |
| $0.068 / sekundę |
Zastosowania
Najtańszy test klatki początkowej
Najpierw uruchom standardowy poziom 720p, by sprawdzić, czy akcja, ruch kamery lub kadrowanie wygląda tak, jak chcesz, zanim wydasz więcej na wyższy poziom lub nowszą generację.
Sekwencja dwuklatkowa z ustalonym zakończeniem
Użyj poziomu 1080p pro z image_url i last_image_url, gdy liczy się dokładna ostateczna poza – na przykład ostatnie ujęcie przed cięciem.
Wskazówki
Opisz jedno ciągłe działanie, od początku do końca
Powyższy przykład z walką na miecze na dachu nazywa jeden łuk – od zamachu do finalnej postawy obronnej; taka struktura jednego momentu jest w tej generacji bardziej niezawodna niż kilka odrębnych działań upchniętych w jednym prompcie.
Nie oczekuj, że długie, ciągnące się detale zachowają kształt
Długie włosy, wlokąca się tkanina czy powiewające rekwizyty to rodzaj detalu, który ta generacja łatwo gubi w ciągu 10 sekund – długi aksamitny tren wyraźnie się skrócił w połowie jednego z naszych testów na schodach. Trzymaj takie detale krótkie albo zaplanuj poprawki później.
Dopasuj wybór rozdzielczości do potrzeb ujęcia
Zrób najpierw test w 720p, gdy wciąż dopracowujesz akcję lub ruch kamery, a poziom pro 1080p – z opcjonalną klatką końcową – zachowaj na ujęcie, które chcesz zatrzymać.
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.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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
