Kling 4.0

Kling 4.0 to model wideo od Kuaishou ogłoszony we wrześniu 2026. Jeden ID modelu obejmuje pięć trybów: tekst na wideo, obraz na wideo z do 10 klatkach kluczowymi, generowanie oparte na referencjach z obrazów, wideo i audio, edycja wideo i wydłużanie wideo. Każdy klip to 3–30 sekund w 720p lub 1080p z dźwiękiem stereo. Wyślij żądanie, zachowaj zwrócony ID zadania i przeczytaj gotowe wideo z tego zadania. Media idą jako adresy URL.

ID modeli

Aktualne ceny znajdziesz na stronie modelu.

Krótki przykład

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"
  }'

Punkt końcowy

POST https://api.seedrouter.ai/v1/videos/generations

Odpowiedź to zadanie ({"id": "task_...", "status": "processing"}), a nie gotowe wideo. Odpytuj GET /v1/tasks/{task_id} po wynik. Zachowaj klucze API w kodzie po stronie serwera.

Parametry

Każdy klip ma dźwięk stereo; nie ma przełącznika dźwięku. Nie ma pól mode, negative_prompt, watermark albo wieloujęciowych. Schemat jest ścisły: nieznane pola są odrzucane, nie ignorowane. callback_url nie jest dostępny; odpytuj zadanie zamiast tego.

Tryby

Tryb następuje media, które wysyłasz i omni_reference_task_type:

Klatki i media referencyjne nie mogą być mieszane w jednym żądaniu. Obok wideo referencji albo audio, image_urls liczą się jako obrazy referencyjne tylko z omni_reference_task_type: "reference"; używaj ról reference_image inaczej. video_url bez edit albo extend jest odrzucany.

Klatki kluczowe

{
  "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
}

Referencje

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

Edycja

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

Wideo wejściowe musi mieć co najmniej 3 sekundy; używane są tylko jego pierwsze 30 sekund. Bez duration wyjście następuje wideo wejściowe.

Wydłużanie

{
  "model": "kling-4-0",
  "prompt": "The camera keeps moving forward as the sky grows darker",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 5
}

Wydłużanie kontynuuje od ostatniej klatki wideo wejściowego i zwraca oryginał plus nową część. Dodaj last_frame_image, by wybrać, gdzie się kończy.

Wejścia mediów

Obrazy, wideo i audio to publiczne adresy URL HTTP(S). Identyfikatory danych base64 nie są akceptowane: prześlij pliki do swojego magazynu i podaj ich adresy URL. Obrazy, wideo i audio razem to maksymalnie 15 plików referencyjnych.

Wymiary cen

Aktualne stawki sprawdź na sekcji cen modelu. Kling 4.0 jest rozliczany za sekundę wideo, według stawki ustalonej przez rozdzielczość:

text, image, reference without videos:  cost = duration × standard rate
extend:                                 cost = new seconds × standard rate
edit, reference with videos:            cost = (output + max(output, input)) × video-input rate

wejście to sumaryczna długość wideo wejściowego, zaokrąglona do całych sekund i ograniczona do 30. Jest mierzone, gdy żądanie jest przyjęte, więc zarezerwowana kwota to rozliczana kwota. Wideo, którego długość nie można odczytać, jest odrzucane, zanim cokolwiek zostanie rozliczone. Przykład: edycja 5,2-sekundowego wideo na 3-sekundowy wynik rozlicza 3 + 6 = 9 sekund. Nieudane zadania nie są rozliczane.

Schemat wyjścia

Przesłanie zwraca zadanie:

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

Pobierz zadanie

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Odpytuj co 10–20 sekund, aż status wyniesie completed albo failed. Limit czasu sieci podczas odpytywania nie oznacza, że generowanie się nie powiodło: zachowaj ID zadania i wznów jego sprawdzanie. Nie twórz innego zadania, by sprawdzić postęp.

Zakończone zadanie

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

W naszych testach 3-sekundowe klipy 720p wracały jako MP4 (H.264) w rozdzielczości 1280 × 720 z dźwiękiem stereo AAC, 2 min 41 s do 4 min 22 s po przesłaniu. Wydłużone 5,2-sekundowe wideo wracało jako 8,1 sekund.

Błędy

Żądania odrzucone, zanim zostanie utworzone zadanie, zwracają błąd HTTP z obiektem error i nie są rozliczane. Zadanie, które się nie powiedzie po akceptacji, zwraca HTTP 200 po zapytaniu, z status: "failed" i obiektem error.

Zobacz wspólny katalog błędów po kody, statusy HTTP i wskazówki dotyczące ponownych prób.

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Jeśli limit czasu przesłania się skończy, sprawdź swoje zadania przed ponownym przesłaniem: pierwsze żądanie mogło zostać zaakceptowane.

Porady

• Opisz temat, miejsce, ruch kamery, światło i dźwięk; dźwięk klipu następuje prompt.
• Robisz szkice w 720p, potem renderuj finalny klip w 1080p z tym samym żądaniem.
• Daj dłuższym klipom klatki kluczowe, by scena poruszała się tam, gdzie chcesz.
• Dodaj no text, no logos, by trzymać wynalezione znaki poza nim.

Powiązane

• Kling 4.0 Playground i cennik
• Dokumentacja API Kling 3.0
• Pobierz OpenAPI
• Markdown do skopiowania