Wprowadzenie
Tekst na wideo w Kling 3.0 Turbo zamienia pisaną scenę w klip trwający od 3 do 15 pełnych sekund, w 720p lub 1080p, z dźwiękiem generowanym w tym samym przebiegu. Ten endpoint nie ma trybu ciszy: opisz w prompcie dialog i dźwięk otoczenia, których chcesz, a wyrenderują się razem z obrazem.
Wybierz tryb Kling 3.0 Turbo według materiału startowego
| Co masz na starcie | Tryb |
|---|---|
| pisaną scenę | Kling 3.0 Turbo – tekst na wideo |
| zatwierdzony obraz początkowy | Kling 3.0 Turbo – obraz na wideo |
Najważniejsze funkcje
Dźwięk nie jest opcjonalny, i o to chodzi
Każdy klip z tego endpointu niesie generowaną ścieżkę dźwiękową: dialog wpisany w cudzysłowie renderuje się jako wypowiedziane kwestie, a każdy nazwany dźwięk otoczenia – muzyka, kroki, ruch uliczny – wraca wmiksowany w obraz. W naszych testach wypowiedziane kwestie zgadzały się z promptem słowo w słowo w każdym uruchomionym klipie. Nie ma pola, by wyłączyć audio; po cichy klip 1080p użyj zamiast tego Kling 2.5 Turbo.
Jedno ciągłe ujęcie, brak pola do cięcia ujęć
Ten endpoint nie ma ustawienia wielu ujęć, więc każdy klip odtwarza się jako jedno nieprzerwane ujęcie. Opisz jedną wyraźną akcję od początku do końca – taniec, sprint i skok, obrót w stronę kamery – zamiast kilku momentów, które chcesz sklejone razem.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Napisz go jak ujęcie: kto jest w kadrze, akcja, ruch kamery, a potem dźwięk – dialog w cudzysłowie i dźwięki otoczenia, których chcesz. od 1 znaków · do 2500 znaków |
aspect_ratio | Nie | 16:9, 9:16 lub 1:1. Wybierz przed napisaniem promptu, by treść umieszczała podmiot pod tę klatkę. |
resolution | Nie | 720p lub 1080p. Wyższe poziomy kosztują więcej za sekundę. |
duration_seconds | Nie | Pełne sekundy, od 3 do 15. Determinuje cenę razem z rozdzielczością. |
Cennik
Rozliczane za sekundę wyjścia; zarówno rozdzielczość, jak i długość wpływają na stawkę.
| Specyfikacja | Cena |
|---|---|
| $0.112 / sekundę |
| $0.14 / sekundę |
Zastosowania
Sceny dialogowe do shortów i rolek
Dwoje ludzi rozmawiających, śmiejących się lub wymieniających kwestię sprawdza się tu dobrze, ponieważ dźwięk wraca zsynchronizowany z obrazem, zamiast dogrywany później. Testowana przez nas scena w kuchni dostarczyła wypowiedzianą kwestię, muzykę w tle i dźwięk bulgoczącego garnka - wszystko w tym samym pliku, bez potrzeby osobnego etapu dźwięku przed publikacją.
Klipy akcji i ruchu z pasującym dźwiękiem
Parkour, taniec i inna aktywność fizyczna trafiają z krokami, uderzeniami i oddechem wbudowanymi w ten sam plik co ruch, bez osobnego przebiegu udźwiękowienia do dograna.
Szybkie w realizacji klipy społecznościowe, które potrzebują dźwięku od razu
Ponieważ dźwięk jest generowany w tym samym przebiegu co obraz, ten endpoint pasuje do każdego krótkiego klipu trafiającego prosto na feed lub rolkę, gdzie czekanie na osobny etap projektowania dźwięku spowolniłoby publikację.
Wskazówki
Napisz ujęcie w kolejności, w jakiej się dzieje
Ułóż prompt jako: podmiot, akcja, kamera, potem dźwięk. Prompt z kuchenną salsą to sprawny szablon: kto tańczy i w co jest ubrany, co robi (obroty, uderzenie o blat), kamera (średnie ujęcie, delikatnie z ręki), a potem dźwięk (muzyka, śmiech, bulgoczący garnek).
Dopasuj dźwięk do akcji, nie tylko do nastroju
Nazywaj dźwięki, które są spowodowane czymś w kadrze – kroki na betonie, bulgoczący garnek, silnik skutera – zamiast generycznej ścieżki nastrojowej. W naszych testach dźwięk powiązany z widoczną akcją renderował się bardziej konsekwentnie zsynchronizowany z obrazem niż wskazówka atmosferyczna bez niczego w kadrze, co by ją wywoływało.
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-turbo/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.











