Wprowadzenie
Kling 4.0 Obraz na wideo animuje klatkę otwierającą w klip od 3 do 30 sekund w 720p lub 1080p. Dodaj klatkę zamykającą, by określić koniec, i do 8 klatek pośrednich, w kolejności, by poprowadzić ruch między nimi. Prompt jest opcjonalny; każdy klip wraca z dwukanałową ścieżką dźwiękową.
Wybierz tryb Kling 4.0 według materiału wyjściowego
| Co masz na starcie | Tryb |
|---|---|
| napisaną scenę lub scenariusz | Kling 4.0 Tekst na wideo |
| klatkę otwierającą, a opcjonalnie zamykającą i klatki pośrednie | Kling 4.0 Obraz na wideo (tutaj jesteś) |
| zdjęcia, klipy lub próbki głosu do obsadzenia | Kling 4.0 Wideo z referencji |
Najważniejsze funkcje
Klatka pierwsza, klatki pośrednie, klatka ostatnia
image_url ustawia otwarcie, last_image_url zakończenie, a keyframe_image_urls punkty pośrednie, w kolejności, w jakiej mają się pojawić. W naszym teście astronomka przy teleskopie (otwarcie), pochylająca się do okularu (klatka pośrednia) i opierająca się o barierkę ze skrzyżowanymi ramionami (zamknięcie) wyszła jako jeden ciągły, 3-sekundowy ruch przez wszystkie trzy pozy.
Kształt idzie za klatką
Zostaw aspect_ratio na auto, a klip zachowa kształt klatki otwierającej; wybierz 16:9, 9:16, 1:1 lub 21:9, aby go nadpisać.
Dźwięk przychodzi razem z klipem
Każdy klip ma dwukanałową ścieżkę dźwiękową. Opisz dźwięk w prompcie, żeby nim sterować.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Nie | Opcjonalny. Opisz, co dzieje się po klatce otwierającej - akcję, kamerę i dźwięk. od 1 znaków |
image_url | Tak | Klatka otwierająca, JPEG lub PNG. Klip zaczyna się od tego obrazu. |
last_image_url | Nie | Opcjonalna klatka zamykająca. Klip kończy się tym obrazem; zachowaj tę samą postać, scenerię i pozycję kamery co w klatce otwierającej. |
keyframe_image_urls | Nie | Opcjonalne klatki pośrednie, do 8, w kolejności, w jakiej mają się pojawiać między klatką otwierającą a zamykającą. Nie są nazywane w prompcie i nie zmieniają ceny. od 1 elementów · do 8 elementów |
aspect_ratio | Nie | auto (domyślnie) zachowuje kształt klatki otwierającej; 16:9, 9:16, 1:1 lub 21:9 go nadpisują. Nie zmienia ceny. |
resolution | Nie | 720p lub 1080p (domyślnie 720p). 1080p kosztuje więcej za sekundę. |
duration_seconds | Nie | Pełne sekundy od 3 do 30 (domyślnie 5). Wpływa na cenę. |
Cennik
Rozliczane za sekundę wyniku. 1080p kosztuje więcej za sekundę niż 720p. Każdy klip ma dwukanałową ścieżkę dźwiękową bez dodatkowej opłaty. Odrzucone lub nieudane żądanie nie jest pobierane.
| Specyfikacja | Cena |
|---|---|
| $0.216 / sekundę |
| $0.324 / sekundę |
Zastosowania
Ożyw nieruchomy kadr
Portret, zdjęcie produktu lub klatka z wcześniejszego klipu - opisz tylko, co dzieje się dalej, a wygląd, strój i otoczenie wezmą się z twojego obrazu.
Od storyboardu do ruchu
Naszkicuj lub wygeneruj kluczowe pozy ujęcia, wgraj je jako klatki otwierającą, pośrednie i zamykającą, a model wypełni ruch między nimi.
Kontynuuj scenę
Weź ostatnią klatkę poprzedniego klipu jako klatkę otwierającą następnego, by zachować postać i scenerię spójne między ujęciami.
Wskazówki
Utrzymuj spójność klatek
Klatki otwierająca, pośrednie i zamykająca powinny mieć tę samą postać, strój, scenerię i pozycję kamery. Klatki, które się nie zgadzają, wymuszają cięcie lub morf.
Opisz ruch, nie obraz
Obraz już pokazuje, jak wszystko wygląda. Poświęć prompt na akcję, ruch kamery i dźwięk.
Mniej, za to czytelniejszych klatek kluczowych
Każda klatka pośrednia to punkt, przez który klip musi przejść. Przy krótkim klipie wystarczy jedna lub dwie; zbyt wiele w kilka sekund sprawi, że ruch będzie pospieszny.
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/4.0/image-to-video",
"input": {
"aspect_ratio": "auto",
"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.










