Wprowadzenie
Kling 4.0 Flash w trybie edycji wideo zaczyna od gotowego klipu i wymaganej instrukcji opisującej zmianę. Prześlij źródło o długości 3–20 sekund oraz, jeśli się przydadzą, do 10 obrazów referencyjnych. Wynik w 720p zachowuje scenę, postać, ruch i prowadzenie kamery ze źródła, wprowadzając opisaną zmianę.
Długość wyniku odpowiada źródłu, a źródła dłuższe niż 20 sekund są w tym miejscu przycinane. W naszych testach zmiana stroju w obserwatorium zachowała długość źródła wynoszącą 5,04 sekundy. Dźwięk źródła jest domyślnie zachowywany; ustaw keep_original_audio na false, aby wygenerować nowy zsynchronizowany dźwięk.
Najważniejsze funkcje
- Przygotuj poprawkę obrazu na podstawie istniejącego występu i ruchu kamery.
- Dodaj do 10 obrazów referencyjnych, gdy edycja wymaga konkretnego odniesienia wizualnego.
- Zachowaj długość źródła w wyniku, przy limicie materiału źródłowego wynoszącym 20 sekund.
- Domyślnie zachowaj oryginalną ścieżkę dźwiękową lub wygeneruj nowy zsynchronizowany dźwięk.
- Odbierz wynik 720p z kadrowaniem auto lub jedną z czterech obsługiwanych proporcji.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagane instrukcje edycji bez gotowego tekstu; opisz zmianę oraz scenę, postać, ruch i prowadzenie kamery do zachowania. Sama instrukcja nie powoduje dodatkowej opłaty. od 1 znaków |
video_url | Tak | Wymagany URL jednego klipu źródłowego o długości 3–20 sekund, bez domyślnego źródła; dłuższe wejścia są przycinane po 20 sekundach. od 1 znaków |
reference_image_urls | Nie | Opcjonalnie dodaj do 10 adresów URL obrazów kierujących edycją, oznaczając je @Image1, @Image2 i kolejnymi numerami zgodnie z kolejnością przesyłania. od 1 elementów · do 10 elementów |
aspect_ratio | Nie | Użyj auto, by dopasować kadr do wideo źródłowego, lub ustaw 16:9, 9:16, 1:1 albo 21:9 dla wyniku. To ustawienie nie zmienia opłaty za edycję. |
keep_original_audio | Nie | Domyślnie true, aby zachować dźwięk źródła; false generuje nową zsynchronizowaną ścieżkę dźwiękową. Zmiana tej wartości nie powoduje osobnej opłaty. Domyślnie: |
Cennik
$0.151 / sekunda
Edycja jest rozliczana za sekundę źródła zaokrągloną w górę do kolejnej pełnej sekundy, maksymalnie za 20 sekund. Źródło o długości 5,04 sekundy liczy się jako 6 płatnych sekund, nawet gdy wynik nadal trwa 5,04 sekundy. Prompt, obrazy referencyjne, proporcje i wybór dźwięku nie powodują osobnych opłat. Żądania odrzucone przez moderację Kling nie są rozliczane.
Zastosowania
- Wypróbuj szmaragdową suknię wieczorową w klipie z obserwatorium, zachowując akcję.
- Oceń różne kolory płaszcza w kolejnych wersjach krótkiej sceny społecznościowej.
- Przygotuj warianty wizualne szkicu nagranego ruchu z zachowaniem źródłowej ścieżki dźwiękowej.
Wskazówki
- Zacznij od tego, co zachować, na przykład „zachowaj scenę i ruch kamery”, by określić stałe elementy edycji.
- Wskaż jedną konkretną zmianę, na przykład „zmień kolor płaszcza na grafitowy”, zanim poprosisz o kilka wariantów.
- Przypisz rolę każdemu dodanemu obrazowi, na przykład „użyj kurtki pokazanej na @Image1”, by powiązać referencję ze zmianą.
- Opisz jednocześnie materiał i kolor, na przykład „szmaragdowa aksamitna suknia”, gdy edycja dotyczy stroju.
- Aby uzyskać nową ścieżkę dźwiękową, wyłącz
keep_original_audioi dodaj wskazówkę w rodzaju „Dźwięk: niski szum silnika i wieczorny wiatr”.
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/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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.
