Jak używać Kling 4.0 API: tryby, klatki kluczowe, referencje, edycja i wydłużanie

By używać API Kling 4.0, utwórz klucz API, wyślij metodą POST jedną treść JSON z ID modelu kling-4-0 i swoim promptem, a potem odpytuj zadanie, które zwraca, aż adres URL wideo będzie gotowy. Ten sam punkt końcowy obejmuje wszystkie pięć trybów: tekst na wideo, obraz na wideo z do 10 klatkach kluczowymi, referencje z obrazów, wideo i audio, edycja wideo i wydłużanie wideo. Media, które wysyłasz i jedno pole, omni_reference_task_type, decydują, który tryb runs.

Ten poradnik przechodzi przez każdy tryb z treściami żądań, które działały 22 października 2026, a potem pokazuje, jak każdy tryb jest rozliczany i które żądania są odrzucane, zanim cokolwiek jest rozliczane.

Czego potrzebujesz przed pierwszym żądaniem?

1. Klucz API. Utwórz go na stronie kluczy API i zachowaj go na swoim serwerze. Nigdy nie umieszczaj go w kodzie przeglądarki.
2. Środki. Dodaj saldo na stronie rozliczeń. Środki nigdy nie przepadają, a nieudane zadania nie są rozliczane.
3. ID modelu kling-4-0.

export SEEDROUTER_API_KEY="your-key"

Jak wysłać żądanie Kling 4.0?

Wyślij zadanie metodą POST na /v1/videos/generations:

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Odpowiedź to zadanie, a nie wideo:

{"id": "task_...", "model": "kling-4-0", "status": "processing", "created_at": 1789689600}

Każde pole poza model i, w większości trybów, prompt ma domyślną wartość:

Nie ma przełącznika dźwięku: każdy klip Kling 4.0 ma ścieżkę stereo. Nie ma też pola mode, negative_prompt albo watermark. Schemat jest ścisły, więc nieznane pole jest odrzucane z HTTP 400, zanim zostanie utworzone zadanie i literówka nigdy nie zamieni się na płatny klip z ustawieniem po cichu zignorowanym.

Jak odebrać wideo?

Odpytuj GET /v1/tasks/{id} co 10–20 sekund, aż status wyniesie completed albo failed. Nasze pięć uruchomień testowych zajęło między 2 minutami 41 sekundami a 4 minutami 22 sekundami dla 3-sekundowych 720p klipów, więc planuj minuty, nie sekundy.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

Zakończone zadanie wygląda tak:

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "completed",
  "output": {"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"}
}

To jest klip, który pierwsze żądanie na tej stronie wyprodukowało, 5 sekund w 720p:

Kling 4.0, tekst na wideo, 720p, 5 sekund, z dźwiękiem stereo.

Nasze 720p klipy wracały jako MP4 (H.264) w rozdzielczości 1280 × 720 z dźwiękiem stereo AAC. Pobierz plik do swojego magazynu: hostowane linki nie są trwałe. Limit czasu sieci podczas odpytywania nie oznacza, że generowanie się nie powiodło, więc zachowaj ID zadania i sprawdź go ponownie zamiast przesyłać nowe zadanie.

Który tryb uruchamia żądanie Kling 4.0?

Media w treści wybierają tryb. omni_reference_task_type czyni to jednoznacznym, gdzie media samym nie byłyby:

Klatki i media referencyjne nie mogą być mieszane w jednym żądaniu, i video_url bez edit albo extend jest odrzucany. Oba wracają jako HTTP 400, zanim zadanie istnieje.

Jak ustalisz klatki kluczowe w Kling 4.0?

Wyślij image_with_roles, listę obiektów {url, role}. Dokładnie jeden first_frame, opcjonalny last_frame i do 8 wpisów keyframe, 10 obrazów łącznie. Klatki kluczowe są używane w kolejności, w której je wymieniasz, więc lista to oś czasu.

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

Dla tylko startu i końca, image_urls: [first, last] jest krótsze. Obraz na wideo to jedyny tryb, gdzie prompt może być pominięty; klip przejmuje kształt pierwszej klatki.

Jak używasz obrazów, wideo i audio jako referencji?

Dodaj video_urls (do 5 klipów, 30 sekund użytych łącznie), audio_urls (do 3 klipów od 5–30 sekund) i obrazy referencyjne, maksymalnie 15 plików łącznie. Wspominaj o nich w promptie jako @Image1, @Video1 i @Audio1, numerowane od 1 w każdej liście:

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the deck of the sailboat from @Video1 at sunset",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/boat.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

Obrazy referencyjne mogą też iść w image_urls, ale tylko z omni_reference_task_type: "reference"; bez tego, image_urls są czytane jako pierwsze i ostatnie klatki. Dźwięk wideo referencji jest domyślnie zastępowany; ustaw audio_setting: "origin", by go zachować.

Jak edytujesz wideo z Kling 4.0?

Ustaw omni_reference_task_type na edit, przekaż wideo w video_url i opisz zmianę. Do 10 obrazów referencyjnych może iść w image_urls.

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening with falling snow",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

Wejście musi mieć co najmniej 3 sekundy długości i tylko pierwsze 30 sekund są używane. Pomiń duration i wynik następuje długość wideo wejściowego; oryginalny dźwięk jest zachowywany, chyba że ustalisz audio_setting: "auto".

Jak wydłużasz wideo?

Ustaw omni_reference_task_type na extend, przekaż wideo i podaj duration jako długość nowej części. Kling 4.0 kontynuuje od ostatniej klatki i zwraca oryginał plus nowe sekundy jako jeden plik. W naszym teście 5,2-sekundowy klip wydłużony o 3 sekundy wracał jako 8,1 sekund.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

Dodaj last_frame_image, by wybrać, gdzie nowa część się kończy. Wydłużanie zachowuje stosunek wejścia i dźwięk, więc aspect_ratio i audio_setting są odrzucane.

Ile kosztuje żądanie Kling 4.0?

Kling 4.0 jest rozliczany za sekundę wideo według stawki ustalonej przez rozdzielczość. Sekundy, które liczą się, zależą od trybu:

Wejście to sumaryczna długość wideo wejściowego, zaokrąglona do całych sekund i ograniczona do 30. Jest mierzone, gdy żądanie jest akceptowane, więc zarezerwowana kwota to rozliczana kwota. W naszym teście edycji 5,2-sekundowe wejście i 3-sekundowy wynik rozliczyło 3 + 6 = 9 sekund. To bieżące stawki:

Wideo, którego długość nie można odczytać, jest odrzucane, zanim cokolwiek jest rozliczane, a zadanie, które się nie powiedzie, nie jest rozliczane.

Które żądania są odrzucane, zanim cokolwiek jest rozliczane?

To wracają jako HTTP 400 przy przesłaniu, bez utworzonego zadania i bez niczego rozliczanego:

Zadanie, które jest zaakceptowane i potem się nie powiedzie, na przykład na polityce zawartości modelu, zwraca status: "failed" z kodem error i nie jest rozliczane. Katalog błędów wymienia kody.

Czy agent kodowania może to uruchomić dla ciebie?

Tak. Strona Kling 4.0 ma gotowy prompt dla Claude Code, Codex albo Cursor, który czyta klucz z twojego środowiska, pokazuje ci żądanie i jego koszt, czeka na twoją zgodę, potem przesyła, odpytuje i pobiera klip. Ta sama strona ma playground, który wysyła dokładnie treść, którą wysłałby twój kod, z każdym polem pogrupowanym wg trybu.

Pytania o API Kling 4.0

Czy API Kling 4.0 jest darmowe?

Nie. Jest rozliczane za sekundę wideo. Nowe konta SeedRouter dostaną mały kredyt, by go spróbować, nie ma subskrypcji, a nieudane zadania nie są rozliczane.

Czy Kling 4.0 Flash jest w API?

Jeszcze nie. Kling 4.0 Flash to osobny, lżejszy model w tej samej rodzinie; Kling wypisuje go z krótszymi 720p klipami i bez wielouklatek kluczowych.^[1] ID modelu kling-4-0 to pełny Kling 4.0.

Jak Kling 4.0 różni się od Kling 3.0 w API?

Kling 4.0 tworzy klipy do 30 sekund, przyjmuje klatki kluczowe, referencje wideo i audio, i może edytować albo wydłużać wideo; dźwięk jest zawsze włączony. Kling 3.0 tworzy 3–15-sekundowe klipy, oferuje 4K, wieloujęciowe prompty i nazwane elementy, i ma przełącznik dźwięku. Poradnik API Kling 3.0 obejmuje jego pola. Kling ogłosił 4.0 ze swoją 30-sekundową długością, 10 klatkach kluczowych i dźwiękiem stereo 30 września 2026.^[2]

Czy mogę anulować zadanie?

Nie. Gdy jest zaakceptowane, zadanie będzie realizowane do ukończenia albo porażki. Nieudane zadania nie są rozliczane.

Referencje

1. Kling AI. Kling 4.0 video generation (przegląd funkcji i FAQ). Sprawdzono 8 października 2026 r. na kling.ai.
2. Kling AI. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. 30 września 2026. Sprawdzono 8 października 2026 r. na kling.ai.