Kling 4.0 Flash

Kling 4.0 Flash to mniejszy model w rodzinie Kling 4.0 od Kuaishou. W SeedRouter obsługuje tekst na wideo i generowanie na podstawie referencji: do 10 obrazów referencyjnych, do 5 filmów referencyjnych i do 7 elementów (nazwanych obiektów utworzonych z 2–4 obrazów lub jednego krótkiego filmu), z których każdy jest wskazany w prompcie. Każdy klip trwa 3–20 sekund w 720p z dźwiękiem. Wyślij żądanie, zachowaj zwrócony ID zadania i odczytaj gotowe wideo z zadania. Media są przekazywane 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-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "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; nie ma przełącznika dźwięku. Nie ma pól pierwszej, środkowej ani ostatniej klatki ani pól negative_prompt, watermark czy samodzielnego pola voices: przypisz głos do elementu za pomocą voice_url. Schemat jest ścisły: nieznane pola są odrzucane, nie ignorowane. callback_url nie jest dostępny; odpytuj zadanie zamiast tego.

Wzmianki

Każdy przesyłany materiał jest opcjonalny; bez materiałów żądanie to zwykłe generowanie wideo z tekstu. Gdy przesyłasz materiały, wskaż je w prompcie:

Każde @, po którym następuje litera, cyfra, podkreślenie lub chiński znak, musi wskazywać materiał z tego żądania. W przeciwnym razie żądanie jest odrzucane, zanim zostaną naliczone jakiekolwiek opłaty. Nazwy są dopasowywane od najdłuższej, bez rozróżniania wielkości liter. Po nazwie kończącej się literą, cyfrą lub podkreśleniem nie może od razu następować kolejny taki znak: @image_12 przy jednym obrazie zostanie odrzucone; napisz @image_1 2 lub @image_1,.

Filmy referencyjne i elementy wideo to łącznie najwyżej 5 pozycji, a obrazy, filmy i elementy razem — najwyżej 15.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

Elementy

Element to nazwany obiekt, którego możesz wielokrotnie używać w prompcie. Są dwa rodzaje:

Nazwy składają się z 1–20 liter, cyfr, podkreśleń lub chińskich znaków i muszą być unikalne bez rozróżniania wielkości liter. image_N, video_N, keyframe_N, object_N, audio_N, first_frame i last_frame są zarezerwowane.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

Wejścia mediów

Obrazy, wideo i audio to publiczne adresy URL HTTP(S). Identyfikatory URI danych base64 nie są akceptowane: prześlij pliki do swojego magazynu i podaj ich adresy URL. Filmy referencyjne i elementy wideo muszą trwać łącznie 2–20 sekund; ich długość jest odczytywana przy przyjęciu żądania, a film, którego długości nie można odczytać, jest odrzucany, zanim zostaną naliczone jakiekolwiek opłaty.

Wymiary cen

Aktualne stawki sprawdź w sekcji cen modelu. Kling 4.0 Flash jest rozliczany za sekundę wideo w 720p:

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input to łączna długość filmów referencyjnych i elementów wideo, zaokrąglona w górę do pełnych sekund. Jest mierzona przy przyjęciu żądania, więc zarezerwowana kwota jest kwotą naliczaną. Przykład: 5-sekundowy klip generowany z użyciem filmu referencyjnego o długości 7,2 sekundy rozlicza się jako 5 + 8 = 13 sekund; z 3-sekundowym filmem referencyjnym jest to 5 + 5 = 10 sekund. Nieudane zadania nie są rozliczane.

Schemat wyjścia

Przesłanie zwraca zadanie:

{"id": "task_...", "model": "kling-4-0-flash", "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-flash",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

W naszych testach 5-sekundowe klipy wracały jako MP4 (H.264) w rozdzielczości 1280 × 720 ze ścieżką stereo AAC, 91–103 sekundy po przesłaniu; plik trwa o około jedną klatkę dłużej niż duration (5,04 sekundy dla 5).

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-flash",
  "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 obiekt, miejsce, ruch kamery, światło i dźwięk; dźwięk klipu jest zgodny z promptem.
• Używaj Flash do taniego testowania promptów, proporcji obrazu i referencji, a następnie przenieś udane ujęcie do Kling 4.0, gdy potrzebujesz 1080p, klatek kluczowych, edycji lub wydłużania.
• Dla powracającej postaci utwórz element z dwoma lub trzema wyraźnymi widokami zamiast jednego obrazu referencyjnego.
• Dodaj no text, no logos, by uniknąć zmyślonych znaków.

Powiązane

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