Kling 3.0 Turbo

Generuj w Kling 3.0 Turbo 3–15-sekundowe klipy z dźwiękiem z promptu albo z pierwszej klatki, w 720p lub 1080p, rozliczane za sekundę i dostarczane przez zadanie.

Kling 3.0 Turbo to model wideo z rodziny Kling 3.0 od Kuaishou. Jedno żądanie tworzy 3–15-sekundowy klip z dźwiękiem z promptu albo z promptu i pierwszej klatki, w 720p lub 1080p. Wyślij żądanie, zachowaj zwrócony identyfikator zadania i odczytaj gotowe wideo z tego zadania. Obrazy przekazujesz jako adresy URL.

ID modeli

ID modelu	Dane wejściowe	Rozdzielczości	Długość
`kling-3-0-turbo`	tekst, pierwsza klatka	`720p`, `1080p`	3–15 sekund

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-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Punkt końcowy

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

Nagłówek	Wartość
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Odpowiedź to zadanie ({"id": "task_...", "status": "processing"}), a nie gotowe wideo. Wynik odczytasz, odpytując GET /v1/tasks/{task_id}. Klucze API trzymaj w kodzie po stronie serwera.

Parametry

Pole	Typ	Domyślnie	Uwagi
`model`	string	wymagane	`kling-3-0-turbo`
`prompt`	string	wymagane	Do 3072 znaków, a z pierwszą klatką do 2500. Wymagane także z pierwszą klatką.
`first_frame_image`	URL	brak	Pierwsza klatka klipu. Bez niej klip powstaje z tekstu.
`resolution`	enum	`720p`	`720p` lub `1080p`.
`duration`	integer	`5`	3–15 sekund.
`aspect_ratio`	enum	`16:9`	`16:9`, `9:16` lub `1:1`. Tylko tekst na wideo: z pierwszą klatką format wyznacza klatka.
`watermark`	boolean	brak	`true` dodaje znak wodny. Gdy pole jest pominięte, klip nie ma znaku wodnego.

Każdy klip ma dźwięk; nie ma ustawienia dźwięku. Schemat jest ścisły: nieznane pola są odrzucane, a nie ignorowane. callback_url nie jest dostępne; zamiast tego odpytuj zadanie.

Obraz na wideo

Przekaż pierwszą klatkę w first_frame_image i opisz w prompt, co dzieje się dalej. Klip zaczyna się od tej klatki i przejmuje jej format, więc aspect_ratio nie jest używane.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

Dane wejściowe multimediów

Pierwsza klatka to publiczny adres URL HTTP(S). Dane base64 (data URI) nie są przyjmowane: prześlij plik do własnego magazynu i przekaż jego adres URL. Użyj obrazu JPG lub PNG o rozmiarze do 10 MB.

Czynniki wpływające na koszt

Aktualne stawki znajdziesz w sekcji cen modelu. Kling 3.0 Turbo jest rozliczany za sekundę wideo według stawki zależnej od rozdzielczości:

cost = duration × rate per second for the resolution

Czas trwania jest znany w chwili przyjęcia żądania, więc zarezerwowana kwota jest kwotą naliczoną. Ostateczne opłaty zobaczysz w historii zużycia swojego konta. Nieudane zadania nie są naliczane.

Schemat odpowiedzi

Wysłanie zwraca zadanie:

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

Pobieranie zadania

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

Odpytuj co 10–20 sekund, aż status przyjmie wartość completed lub failed. Przekroczenie limitu czasu sieci podczas odpytywania nie oznacza, że generowanie się nie powiodło: zachowaj identyfikator zadania i wznów sprawdzanie. Nie twórz kolejnego zadania, aby sprawdzić postęp.

Zadanie zakończone

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "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, a 5-sekundowe klipy 1080p w 1920 × 1080, wszystkie ze stereofoniczną ścieżką audio, od 54 sekund do około 5 minut 20 sekund po wysłaniu.

Błędy

Żądania odrzucone przed utworzeniem zadania zwracają błąd HTTP wraz z obiektem error i nie są naliczane. Zadanie, które zawiodło po przyjęciu, przy odpytaniu zwraca HTTP 200 z status: "failed" i obiektem error.

Kody, statusy HTTP i wskazówki dotyczące ponawiania znajdziesz we wspólnym katalogu błędów.

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "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 został przekroczony przy samym wysyłaniu, przed ponownym wysłaniem sprawdź swoje zadania: pierwsze żądanie mogło już zostać przyjęte.

Wskazówki

Opisz obiekt, miejsce, ruch kamery i światło, każde w jednym zdaniu; model stosuje się do języka operatorskiego, takiego jak „slow push-in” czy „low angle”.
Przygotuj wersję roboczą w 720p, a potem wyrenderuj finalne ujęcie w 1080p tym samym żądaniem.
Z pierwszą klatką opisuj tylko to, co się porusza: klatka już ustala scenę.
Dodaj no text, no logos, aby w kadrze nie pojawiały się wymyślone oznaczenia.