Wprowadzenie
Kling 4.0 Flash w trybie wideo z referencji tworzy nową scenę 720p z wymaganego promptu i przesłanych referencji. Dodaj do 10 obrazów i do 5 klipów wideo o łącznej długości 20 sekund. Oznacz obrazy jako @Image1, a wideo jako @Video1, nadając kolejne numery zgodnie z kolejnością przesyłania.
Wyjaśnij w prompcie, co wnosi każda referencja. W pustynnym przykładzie jeden obraz określa postać, a dwa wideo kierują ruchem kamery w scenie o zmierzchu. Nowe klipy trwają 3–20 pełnych sekund, domyślnie 5 sekund, i zawierają zsynchronizowany dźwięk; keep_original_audio pozwala zachować dźwięk wideo referencyjnego. Pliki audio jako referencje nie są obsługiwane.
Najważniejsze funkcje
- Przypisz w prompcie do 10 obrazów referencyjnych do postaci, przedmiotów lub szczegółów sceny.
- Pokieruj ruchem i kadrowaniem za pomocą do 5 wideo o łącznej długości najwyżej 20 sekund.
- Użyj oznaczeń @Image1 i @Video1, by połączyć opis sceny z przesłanymi plikami.
- Wygeneruj wynik 720p o długości 3–20 sekund z dźwiękiem lub zachowaj dźwięk wideo referencyjnego przez
keep_original_audio. - Dopasuj kadr do wejścia za pomocą auto lub wybierz 16:9, 9:16, 1:1 albo 21:9.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagane instrukcje sceny bez gotowego tekstu; przypisz role do @Image1, @Image2, @Video1 i kolejnych przesłanych plików. Treść promptu nie powoduje osobnej opłaty. od 1 znaków |
reference_image_urls | Nie | Podaj do 10 adresów URL obrazów i oznacz je @Image1, @Image2 i kolejnymi numerami zgodnie z kolejnością przesyłania. Kierują sceną bez zmiany ceny. od 1 elementów · do 10 elementów |
reference_video_urls | Nie | Podaj do 5 adresów URL wideo o łącznej długości 20 sekund i oznacz je @Video1, @Video2 i kolejnymi numerami. od 1 elementów · do 5 elementów |
aspect_ratio | Nie | Wybierz auto, by dopasować kadr do referencji, lub ustaw 16:9, 9:16, 1:1 albo 21:9. Kształt kadru nie wpływa na stawkę za sekundę ani nie powoduje dodatkowej opłaty. |
keep_original_audio | Nie | Ustaw true, by zachować dźwięk wideo referencyjnego, lub false, by wygenerować nową ścieżkę dźwiękową; ustawienie działa po dodaniu wideo referencyjnego. Domyślnie: |
duration_seconds | Nie | Długość wyniku przyjmuje pełne sekundy od 3 do 20, domyślnie 5 sekund. Wpływa na łączny koszt przez liczbę rozliczanych sekund wyniku. |
Cennik
$0.113 / sekunda
Generowanie z referencji jest rozliczane za sekundę wyniku. Dodanie wideo referencyjnego podnosi stawkę za sekundę wyniku; długość wideo referencyjnego nie jest rozliczana osobno. Obrazy referencyjne, treść promptu, proporcje i keep_original_audio nie powodują osobnych opłat. Żądania odrzucone przez moderację Kling nie są płatne.
Zastosowania
- Umieść postać z obrazu w pustynnej scenie do mediów społecznościowych, kierowanej krótkimi klipami z ruchem.
- Sprawdź połączenie postaci i lokalizacji za pomocą osobno oznaczonych obrazów referencyjnych.
- Przygotuj kilka krótkich szkiców scen wokół wybranego ruchu kamery do oceny materiałów.
Wskazówki
- Określ rolę każdego obrazu, na przykład „@Image1 wskazuje postać”, zanim opiszesz nową scenę.
- Wyjaśnij, co przejąć z wideo, na przykład „użyj powolnego najazdu kamery z @Video1”, by nadać referencji konkretny cel.
- Opisz nową scenerię, na przykład „spokojna pustynia o zmierzchu”, by odróżnić zamawianą scenę od materiału referencyjnego.
- Przy szkicu 3-sekundowego wyniku poproś o krótką czynność, taką jak „podróżna zatrzymuje się przy znaku”.
- Gdy generujesz nową ścieżkę dźwiękową, dodaj wskazówkę w rodzaju „Dźwięk: suchy wiatr i odległy pociąg”, by pokierować dołączonym dźwiękiem.
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-flash/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
