Jak używać Kling 3.0 API: klucz, żądanie, odpytywanie, klatki i klipy wieloujęciowe

Żeby używać Kling 3.0 API, utwórz klucz API, wyślij metodą POST jedną treść JSON z ID modelu kling-3-0 i swoim promptem, a potem odpytuj zwrócone zadanie, aż adres URL wideo będzie gotowy. Jeden punkt końcowy obsługuje tekst na wideo, wideo z pierwszej i ostatniej klatki, klipy wieloujęciowe i referencje elementów; o tym, co powstanie, decydują pola w treści żądania.

Ten poradnik omawia każdy krok na działającym kodzie, a potem pokazuje klatki, klipy wieloujęciowe, elementy i żądania, które są odrzucane, zanim cokolwiek zostanie naliczone.

Czego potrzebujesz przed pierwszym żądaniem?

1. Klucza API. Utwórz go na stronie kluczy API i trzymaj na swoim serwerze. Nigdy nie umieszczaj go w kodzie przeglądarki.
2. Środków. Doładuj saldo na stronie rozliczeń. Środki nigdy nie przepadają, a nieudane zadania nie są naliczane.
3. ID modelu kling-3-0.

export SEEDROUTER_API_KEY="your-key"

Jak wysłać żądanie do Kling 3.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-3-0",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Odpowiedź to zadanie, a nie wideo:

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

Każde pole poza model i prompt ma wartość domyślną:

Schemat jest ścisły: nieznane pole jest odrzucane z HTTP 400, zanim powstanie zadanie, więc literówka nigdy nie zamieni się w płatny klip z po cichu zignorowanym ustawieniem.

Jak odebrać wideo?

Odpytuj GET /v1/tasks/{id} co 10–20 sekund, aż status przyjmie wartość completed lub failed. W naszych testach 3-sekundowy klip std był gotowy po około dwóch minutach, a 5-sekundowy klip pro z dźwiękiem po około dwóch i pół.

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-3-0",
        "prompt": "A red paper boat drifting on a calm pond at sunrise, slow push-in, no text, no logos.",
        "mode": "std",
        "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-3-0",
  "status": "completed",
  "output": {"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"}
}

std wrócił w 1280 × 720, a pro w 1920 × 1080, oba jako MP4 (H.264); przy włączonym sound plik zawiera stereofoniczną ścieżkę audio. Pobierz plik do własnego magazynu: hostowane linki nie są trwałe. Przekroczenie limitu czasu sieci podczas odpytywania nie oznacza, że generowanie się nie powiodło, więc zachowaj identyfikator zadania i sprawdź je ponownie, zamiast wysyłać nowe zadanie.

Jak zacząć od pierwszej i ostatniej klatki?

Podaj jeden lub dwa adresy URL obrazów w image_urls. Pierwszy obraz otwiera klip, drugi to miejsce, w którym się kończy. Bez obrazów klip powstaje wyłącznie z promptu.

{
  "model": "kling-3-0",
  "prompt": "The camera glides from the empty street to the lit shop window",
  "image_urls": ["https://example.com/start.png", "https://example.com/end.png"],
  "mode": "pro",
  "duration": 6
}

Obrazy muszą być publicznymi adresami URL HTTP(S), w formacie JPG lub PNG. Dane base64 są odrzucane; najpierw prześlij plik do własnego magazynu.

Jak zrobić klip wieloujęciowy?

Ustaw multi_shots na true i opisz każde ujęcie w multi_prompt, maksymalnie pięć ujęć po 1–12 sekund. Czasy trwania ujęć muszą łącznie dawać 3–15 sekund i ta suma jest długością klipu, za którą płacisz; duration nie jest używane.

{
  "model": "kling-3-0",
  "mode": "pro",
  "sound": true,
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "Wide shot of a small open kitchen, a chef tosses vegetables in a wok, flames rising, warm light.", "duration": 3},
    {"prompt": "Close-up of the wok, vegetables flipping through the flames, oil sizzling, steam drifting.", "duration": 3}
  ]
}

Oto klip, który to żądanie wygenerowało w naszym teście: jedno 6-sekundowe wideo z cięciem od szerokiego ujęcia do zbliżenia.

Kling 3.0, pro (1080p), wieloujęciowy 3 + 3 sekundy, z dźwiękiem.

Jak zachować spójność osoby lub produktu?

Dodaj taki obiekt do kling_elements: name, krótki description i 2–4 adresy URL obrazów obiektu, maksymalnie trzy elementy na żądanie. Wspomnij element z nazwy w prompcie.

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

Które żądania są odrzucane, zanim cokolwiek zostanie naliczone?

Te żądania wracają z HTTP 400 przy wysyłaniu: zadanie nie powstaje i nic nie jest naliczane.

Zadanie, które zostało przyjęte, a potem się nie powiodło, na przykład przez politykę treści modelu, zwraca status: "failed" z kodem w error i nie jest naliczane. Kody znajdziesz w katalogu błędów.

Czym to się różni od własnego API Kling?

API Kling dla deweloperów używa własnych nazw pól, a jego starsza i bieżąca wersja różnią się od siebie.^[1][2] Jeśli przenosisz integrację, zmapuj pola:

SeedRouter dostarcza wyniki jako zadanie, które odpytujesz; callback_url nie jest oferowane.

Czy agent programistyczny może to zrobić za ciebie?

Tak. Na stronie Kling 3.0 jest gotowy prompt dla Claude Code, Codex lub Cursor: agent odczytuje klucz z twojego środowiska, pokazuje ci żądanie i jego koszt, czeka na twoją zgodę, a potem wysyła zadanie, odpytuje je i pobiera klip. Na tej samej stronie jest Playground, który wysyła dokładnie tę treść żądania, którą wysłałby twój kod.

Pytania o Kling 3.0 API

Czy istnieje oficjalne API Kling 3.0?

Tak. Kling udostępnia API dla deweloperów z własnymi kluczami, rozliczaniem w jednostkach i formatem żądania.^[1][3] SeedRouter to osobny sposób wywoływania Kling 3.0 z jednym kluczem i jednym saldem wspólnym z innymi modelami.

Ile kosztuje Kling 3.0 API?

Rozliczenie jest za sekundę wideo, według trybu i tego, czy dźwięk jest włączony. Przewodnik po cenach Kling 3.0 API przelicza koszty klipów, a strona modelu pokazuje aktualne stawki.

Czy mogę anulować zadanie?

Nie. Po przyjęciu zadanie działa aż do zakończenia albo niepowodzenia. Nieudane zadania nie są naliczane.

Źródła

1. Kling AI. Kling 3.0: Text to Video (dokumentacja API, wersja starsza). Dostęp 6 października 2026 r., kling.ai.
2. Kling AI. Kling 3.0: Image to Video (dokumentacja API, wersja starsza). Dostęp 6 października 2026 r., kling.ai.
3. Kling AI. Pricing: Video (API dla deweloperów). Dostęp 6 października 2026 r., kling.ai.