Wprowadzenie
Obraz na wideo w Kling 2.1 Master animuje klatkę początkową w klip 5 lub 10 sekund w 1080p, bez ścieżki dźwiękowej i bez opcji klatki końcowej w tym endpoincie – tylko image_url.
Wybierz tryb Kling 2.1 Master według materiału startowego
| Co masz na starcie | Tryb |
|---|---|
| pisaną scenę | Kling 2.1 Master – tekst na wideo |
| zatwierdzoną klatkę początkową | Kling 2.1 Master – obraz na wideo |
Najważniejsze funkcje
Klatka trwa w bezruchu, prompt dostarcza ruch
Stylizacja, poza, światło i sceneria z klatki początkowej pozostają dokładnie takie, jak zostały wysłane; prompt musi tylko opisać, co dzieje się dalej i dokąd zmierza kamera. W naszych testach zamrożona fala oceaniczna i podwodna suknia balowa ożyły przekonująco z pojedynczej nieruchomej klatki, przy zachowanym kadrze i stroju.
Brak klatki końcowej w tym endpoincie
W przeciwieństwie do standardowego obrazu na wideo w Kling 2.1, obraz na wideo w Master przyjmuje tylko image_url, bez last_image_url. Jeśli liczy się konkretna poza końcowa, opisz ją bezpośrednio w prompcie i pozwól modelowi do niej dążyć, zamiast oczekiwać, że zrobi to druga klatka.
Pionowe klatki mogą sprawiać, że twarz wygląda mniejsza
Gdy klatka początkowa jest pionowym kadrem, render podąża za tym formatem, a w jednym z naszych testów twarz wypadła mniejsza i nieco mniej szczegółowa niż przy klatce poziomej. Ciaśniejsze kadrowanie twarzy w pionowej klatce początkowej przenosi więcej szczegółów do gotowego klipu.
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. |
duration_seconds | Nie | Pełne sekundy, 5 lub 10. Determinuje cenę. |
negative_prompt | Nie | Krótka lista tego, czego klip powinien unikać – przydatne przy odsuwaniu typowych usterek renderowania w złożonych ruchach kamery. 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.216 / sekunda
Rozliczane za sekundę wyjściowego klipu. Przesłany plik odrzucony przez Kling nie jest rozliczany.
Zastosowania
Doprowadź konkretne ujęcie do najlepszej jakości ruchu
Użyj tego poziomu, gdy klatka początkowa jest już dokładnie taka, jak trzeba – światło, stylizacja, poza – a render ma być wersją ostateczną, a nie szkicem do porównania z tańszymi ujęciami.
Atmosferyczny ruch: tkanina, woda, ogień, pył
Powiewające suknie, zwijające się fale, unosząca się mgła i kołyszący się żyrandol renderują się naturalnie w naszych testach na podstawie nieruchomej klatki i promptu opisującego ruch, co pasuje do każdego ujęcia budowanego wokół atmosfery, a nie dialogu czy szybkiej akcji.
Drugi klip w wysokiej jakości w tym samym projekcie
Ponieważ ten endpoint dzieli wyższą cenę Master ze swoim odpowiednikiem tekst na wideo, potraktuj go tak samo: zarezerwuj go dla ujęcia zatwierdzonego już gdzie indziej, a treść promptu dopracuj najpierw na tańszym poziomie.
Wskazówki
Powiedz elementom nieruchomej klatki, kiedy mają ruszyć
Wskaż to, co już jest w klatce – fala, poza, strój – i opisz kolejność, w jakiej ma ożywać, zamiast opisywać całą scenę od nowa; model już wie, jak wygląda obraz.
Połącz negative_prompt z krążącą lub dryfującą kamerą
Krótki negative_prompt, wskazujący na przykład rozmyte twarze lub zniekształcone dłonie, to tani sposób, by odsunąć powolną orbitę lub dryf w stylu podwodnym od najczęstszych usterek renderowania tego modelu, zwłaszcza gdy klip trwa pełne 10 sekund.
Kadruj twarz nieco ciaśniej na pionowych klatkach
Jeśli klatka początkowa jest pionowym kadrem, ustaw twarz bliżej niż zrobiłbyś to przy ujęciu poziomym; szerokie pionowe kadrowanie może sprawić, że twarz będzie wyglądać na małą, gdy klip zacznie się poruszać – tak stało się w jednym z naszych testów z pionową klatką.
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-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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
