Wprowadzenie
Kling 4.0 Wideo z referencji tworzy nowy klip z tego, co wgrasz: do 10 obrazów referencyjnych osób, przedmiotów i miejsc, do 5 wideo referencyjnych (łącznie 30 sekund) dla ruchu, kamery i tempa oraz do 3 nagrań audio dla głosu lub dźwięku. Nazwij każde w prompcie jako @Image1, @Image2, @Video1 lub @Audio1, numerując w kolejności wgrania. Klipy trwają od 3 do 30 sekund w 720p lub 1080p 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 |
| zdjęcia, klipy lub próbki głosu do obsadzenia | Kling 4.0 Wideo z referencji (tutaj jesteś) |
Najważniejsze funkcje
Obrazy, wideo i głosy w jednym żądaniu
Kling 4.0 przyjmuje naraz wszystkie trzy rodzaje referencji. Obrazy określają, kto i co się pojawia, wideo - jak porusza się kamera i podmiot, a nagrania audio - jak ktoś brzmi.
Nazywaj każdą referencję w prompcie
Pisz @Image1, @Image2 i tak dalej w kolejności wgrania i powiedz, czym każda jest. W naszym przykładzie z przyczepą zdanie "@Image1 is the woman, @Image2 is the chrome trailer" wystarczyło, by ta kobieta stanęła przed tą przyczepą.
Pożycz ruch kamery z klipu
Wideo referencyjne przekazuje ruch i tempo. Włącz keep_original_audio, by zachować jego własny dźwięk zamiast generować nowy. Sekundy wideo referencyjnego są też rozliczane, według niższej stawki niż sekundy wyniku.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Opisz, czym jest każda referencja i co ujęcie z nią robi. Pisz @Image1, @Image2 dla obrazów, @Video1 dla wideo i @Audio1 dla nagrań, numerując w kolejności wgrania. od 1 znaków |
reference_image_urls | Nie | Do 10 obrazów osób, przedmiotów, strojów lub miejsc, nazywanych @Image1, @Image2 i tak dalej. Nie zmieniają ceny. od 1 elementów · do 10 elementów |
reference_video_urls | Nie | Do 5 wideo, łącznie 30 sekund, dla ruchu, kamery i tempa, nazywanych @Video1, @Video2. od 1 elementów · do 5 elementów |
reference_audio_urls | Nie | Do 3 nagrań audio po 5 do 30 sekund każde, dla głosu lub dźwięku, nazywanych @Audio1, @Audio2. Wypowiedzi wpisz w prompcie. od 1 elementów · do 3 elementów |
aspect_ratio | Nie | auto (domyślnie) podąża za obrazami lub wideo referencyjnym; 16:9, 9:16, 1:1 lub 21:9 ustawiasz sam. Nie zmienia ceny. |
resolution | Nie | 720p lub 1080p (domyślnie 720p). 1080p kosztuje więcej za sekundę. |
keep_original_audio | Nie | Domyślnie wyłączone. Włączone zachowuje własny dźwięk wideo referencyjnego zamiast generować nową ścieżkę; ma znaczenie tylko wtedy, gdy podajesz wideo referencyjne. Domyślnie: |
duration_seconds | Nie | Pełne sekundy od 3 do 30 (domyślnie 5). Wpływa na cenę. |
Cennik
Rozliczane za sekundę wyniku oraz za sekundy każdego wideo referencyjnego (każdy klip zaokrąglany w górę do pełnej sekundy) według niższej stawki za sekundę. 1080p kosztuje więcej za sekundę niż 720p. Obrazy referencyjne i nagrania audio nie zmieniają ceny. Odrzucone lub nieudane żądanie nie jest pobierane.
| Specyfikacja | Cena |
|---|---|
| $0.216 / sekundę |
| $0.324 / sekundę |
Zastosowania
Umieść osobę w miejscu, w którym nigdy nie była sfotografowana
Portret plus zdjęcie lokalizacji staje się sceną z tą osobą w tym miejscu, z opisaną akcją.
Utrzymaj rekwizyt lub pojazd spójnie
Daj samochodowi, motocyklowi lub strojowi osobny obraz referencyjny, by wyglądał tak samo w każdym klipie.
Dopasuj głos
Dodaj próbkę głosu 5-30 sekund jako @Audio1 i wpisz kwestię w cudzysłowie; wypowiedź pójdzie za tym głosem.
Wskazówki
Zacznij od listy obsady
Zacznij od jednego zdania na referencję - "@Image1 is the man, @Image2 is the motorcycle" - a potem opisz ujęcie.
Kilka wyraźnych referencji wygrywa z wieloma podobnymi
Jedno wyraźne zdjęcie osoby lub przedmiotu działa lepiej niż kilka prawie identycznych, które model musi uśredniać.
Zostaw aspect_ratio na auto
Na auto klip podąża za kształtem referencji; ustaw go tylko wtedy, gdy potrzebujesz konkretnego kadru.
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/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"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.










