Wprowadzenie
Motion Control w Kling 3.0 bierze jedno wyraźne zdjęcie postaci (image_url) i klip sterujący (video_url, 3 do 30 sekund) i odtwarza ruchy, mimikę i gesty dłoni z klipu sterującego na tej postaci, zachowując jej twarz, strój i scenerię ze zdjęcia. Wyjście jest dokładnie tak długie, jak klip sterujący, i jest rozliczane według tej długości, nie wybranego przez Ciebie czasu trwania. prompt jest opcjonalny – użyj go dla wszystkiego, czego klip sterujący nie pokazuje, na przykład scenerii lub wyglądu.
Wybierz tryb Kling 3.0 według materiału startowego
| Co masz na starcie | Tryb |
|---|---|
| pisaną scenę lub scenariusz | Kling 3.0 – tekst na wideo |
| klatkę początkową i opcjonalnie końcową | Kling 3.0 – obraz na wideo |
| zdjęcie postaci i klip sterujący | Kling 3.0 Motion Control (jesteś tutaj) |
Najważniejsze funkcje
Jedno zdjęcie, jeden klip sterujący, ten sam występ dwa razy
Nagraj lub zdobądź licencję na jeden klip sterujący – taniec, chód, gest – i przepuść go przez tyle zdjęć postaci, ile potrzebujesz. W naszym teście układ z tego samego klipu sterującego wrócił dopasowany moment w moment na dwóch różnych postaciach, każda zachowując własną twarz, ubranie i tło.
Wynik trwa tyle, co klip sterujący
Nie ma pola czasu trwania do ustawienia: długość wyjścia zawsze odpowiada klipowi sterującemu, od 3 do 30 sekund, a rozliczenie podąża za tą samą długością.
720p lub 1080p
Motion Control nie sięga do 4K. Rozdzielczość zmienia cenę tak samo jak w pozostałych endpointach Kling 3.0.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Nie | Opcjonalne. Użyj go tylko dla tego, czego klip sterujący nie pokazuje – scenerii, wyglądu, czegokolwiek do dodania. do 2500 znaków |
negative_prompt | Nie | To, czego nie chcesz w klipie – obiekty, wygląd lub ruch – do 2500 znaków. Opcjonalne; nie wpływa na cenę. do 2500 znaków |
image_url | Tak | Postać do animacji: jedno wyraźne zdjęcie całej sylwetki lub górnej połowy ciała osoby. |
video_url | Tak | Klip sterujący, 3 do 30 sekund: ruchy, mimika i gesty do skopiowania. Wynik jest tak długi, jak ten klip, i jest rozliczany według tej długości. |
resolution | Nie | 720p lub 1080p. Wyższy poziom kosztuje więcej za sekundę. |
keep_original_audio | Nie | Zachowuje w wyniku oryginalny dźwięk klipu sterującego. Domyślnie włączone. Domyślnie: |
character_orientation | Nie | W którą stronę zwrócona jest postać w wyniku: video (domyślnie) naśladuje osobę z klipu sterującego, image – osobę z twojego zdjęcia. |
shot_type | Nie | Sposób planowania ujęć: customize (domyślnie) trzyma się podanych danych, intelligent pozwala modelowi samemu zaplanować ujęcia. Nie wpływa na cenę. |
Cennik
Rozliczane według długości klipu sterującego (video_url), zaokrąglonej w górę do pełnej sekundy, od 3 do 30 sekund, nie według wybranego przez Ciebie czasu trwania. Rozdzielczość zmienia stawkę.
| Specyfikacja | Cena |
|---|---|
| $0.1008 / sekundę |
| $0.1344 / sekundę |
Zastosowania
Wykorzystaj jeden występ na wielu postaciach
Wyreżyseruj lub zdobądź licencję na jeden klip sterujący raz, a potem zastosuj go do każdego zdjęcia postaci w serii – układ taneczny, zestaw gestów prezentera produktu, powracające powitanie – bez ponownego kręcenia ruchu za każdym razem.
Nadaj nieruchomemu zdjęciu postaci prawdziwy, wyreżyserowany ruch
Zamiast opisywać ruch słowami i liczyć na konkretny gest, Motion Control pozwala pokazać dokładny ruch raz, jako klip sterujący, i zastosować go precyzyjnie.
Umieść występ w nowej scenerii
Użyj opcjonalnego promptu, by umieścić postać w innej lokalizacji niż tło samego klipu sterującego, podczas gdy sam ruch pozostaje identyczny.
Wskazówki
Niech klip sterujący niesie ruch
Prompt nie musi opisywać żadnego ruchu – klip sterujący już go dostarcza. Użyj go tylko dla tego, czego klip nie pokazuje, na przykład pomieszczenia, szczegółu stroju lub nastroju.
Trzymaj zdjęcie postaci wyraźne i z jednym podmiotem
Wyraźne zdjęcie całej sylwetki lub górnej połowy ciała jednej osoby, dobrze oświetlone i niczym niezasłonięte, daje Motion Control najczystsze dopasowanie. Zdjęcie z częściowo ukrytą postacią lub pod nietypowym kątem zostawia więcej do zgadywania modelowi.
Sprawdź, czy oba wejścia są wystarczająco szerokie
Zarówno zdjęcie postaci, jak i klip sterujący potrzebują z grubsza 720 pikseli lub więcej po każdej stronie; klip sterujący poniżej tego progu jest odrzucany, zanim zadanie się zacznie, a nie po tym, jak już za nie zapłaciłeś.
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/3.0/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
