Wprowadzenie
Obraz na wideo w Kling O3 animuje Twoją własną klatkę początkową. Prześlij obraz, opcjonalnie dodaj klatkę końcową, by ustalić zakończenie, i opisz, co dzieje się pomiędzy – pole prompt przyjmuje do 2500 znaków. Wybierz długość od 3 do 15 pełnych sekund, rozdzielczość do 4K oraz to, czy generować natywny dźwięk razem z obrazem.
Wybierz tryb Kling O3 według materiału startowego
| Co masz na starcie | Tryb |
|---|---|
| pisaną scenę i nic więcej | Kling O3 – tekst na wideo |
| zatwierdzoną klatkę początkową | Kling O3 – obraz na wideo |
| do 7 zdjęć referencyjnych | Kling O3 – reference-to-video |
| wideo, które już masz | Kling O3 – video-edit |
Najważniejsze funkcje
Klatka początkowa jest ściśle przestrzegana
Ktokolwiek i cokolwiek jest w Twojej klatce – ludzie, strój, pokój – to zachowuje klip. W naszym przykładzie z parasolem twarze dwóch kobiet zgadzały się z klatką początkową przez cały pięciosekundowy klip; prompt musiał tylko opisać nową akcję.
Opcjonalna klatka końcowa ustala zakończenie
Dodaj last_image_url, a klip zostanie zbudowany tak, by wylądować na tej klatce zamiast tam, gdzie model inaczej by się zatrzymał. Trzymaj obie klatki blisko siebie pod względem światła, kąta i kadrowania – duży skok między nimi jest tym, co sprawia, że środek długiego klipu się rozjeżdża.
Dźwięk generowany razem z ruchem
generate_audio dodaje dialog, efekty i tło w tym samym przebiegu co animacja, zsynchronizowane z opisaną przez Ciebie akcją, a nie dodane w osobnym kroku później.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Opisz tylko to, co dzieje się po klatce początkowej: akcję, ruch kamery i, z włączonym dźwiękiem, dialog oraz efekty. Klatka już ustaliła kto i gdzie. od 1 znaków · do 2500 znaków |
image_url | Tak | Klatka początkowa. JPEG lub PNG. |
last_image_url | Nie | Opcjonalna klatka końcowa, na której klip ma się zakończyć. |
resolution | Nie | 720p, 1080p lub 4K. Wyższe poziomy kosztują więcej za sekundę. |
generate_audio | Nie | Dodaje generowaną ścieżkę dźwiękową w tym samym przebiegu – dialog w cudzysłowie, efekty, tło. Domyślnie: |
duration_seconds | Nie | Pełne sekundy, od 3 do 15. Determinuje cenę razem z rozdzielczością i dźwiękiem. |
shot_type | Nie | single prosi o jedno ciągłe ujęcie (Kling O3 wciąż może samodzielnie ciąć; dodaj "jedno ciągłe ujęcie, bez cięć", jeśli to ma znaczenie). |
multi_prompt | Nie | Lista ujęć dla |
Cennik
Rozliczane za sekundę wyjścia. Stawka zależy od rozdzielczości i tego, czy natywny dźwięk jest włączony.
| Rozdzielczość | Generuj dźwięk: Nie | Generuj dźwięk: Tak |
|---|---|---|
| $0.0672 / sekundę | $0.0896 / sekundę |
| $0.0896 / sekundę | $0.112 / sekundę |
| $0.336 / sekundę | $0.336 / sekundę |
Zastosowania
Animuj klatkę, którą już zatwierdziłeś
Gdy dokładni ludzie, strój i kompozycja mają znaczenie, wygeneruj lub wybierz nieruchomy obraz najpierw, a potem wyślij go tutaj, zamiast zostawiać te szczegóły pisanemu promptowi, który za każdym razem rysuje je na nowo.
Połącz dwie posiadane klatki
Z ustawionymi zarówno image_url, jak i last_image_url, klip wypełnia wiarygodną ścieżkę ruchu między zatwierdzonym startem a zatwierdzonym końcem – przydatne dla sceny, która musi wylądować na konkretnej finalnej kompozycji.
Dodaj dialog do nieruchomego obrazu, który już lubisz
Włącz generate_audio i opisz kwestię dialogu razem z akcją; klatka dostarcza wygląd, prompt dostarcza ruch i słowa.
Wskazówki
Opisz to, co potem, nie to, co już jest
Nie opisuj ponownie, kto jest w klatce ani w co jest ubrany – obraz już na to odpowiada. Wykorzystaj prompt na to, co się zmienia: akcję, ruch kamery, dźwięk.
Trzymaj klatkę końcową blisko początkowej
Jeśli używasz last_image_url, wybierz lub wygeneruj klatkę o podobnym świetle i kadrowaniu do obrazu początkowego. Bliskie dopasowanie utrzymuje ruch pomiędzy nimi wiarygodny; duży skok prosi model, by wymyślił więcej, niż jest w stanie utrzymać stabilnie.
Zablokuj ujęcie, gdy ciągłość ma znaczenie
Shot_type single to preferencja, nie gwarancja. Dla sceny, która nie może się przeciąć – na przykład jednej nieprzerwanej reakcji – dodaj "jedno ciągłe ujęcie, bez cięć" na końcu promptu.
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/o3/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.












