guides

API Kling 4.0 Flash: parametry, ceny i przykłady kodu

Poyo.ai Team
13 min read
Share:

Najważniejsze wnioski

  • Kling 4.0 Flash to szybki i tańszy poziom Kling 4.0. Tworzy klipy 3–20-sekundowe w 720p z tekstu, obrazu początkowego lub referencji i edytuje istniejące wideo.
  • Jedno ID modelu obsługuje wszystkie tryby. Wyślij "model": "kling-4.0-flash" do POST /api/generate/submit. Dołączone media decydują o trybie: tekst na wideo, obraz na wideo, wideo z referencji lub edycja.
  • W PoYo kosztuje $0.094 za sekundę wyniku (18,8 kredytu) przy zadaniach z tekstu, obrazu i referencji obrazowych, więc 5-sekundowy klip to $0.47, a 10-sekundowy $0.94. Gdy na wejściu jest wideo, stawka wynosi $0.063 za rozliczaną sekundę.
  • Pay-as-you-go z jednym kluczem. PoYo rozlicza Flash z kredytów pay-as-you-go bez subskrypcji, a ten sam klucz i format żądań obsługują Kling 4.0, Gemini Omni i Veo.
  • Wyniki są asynchroniczne. Zapisz task_id, a potem odpytuj GET /api/generate/status/{task_id} albo ustaw callback_url.
  • Przejście na Kling 4.0 to zmiana jednego słowa. Oba modele mają te same pola żądania; Kling 4.0 dodaje 1080p, 30-sekundowe klipy, klatki końcowe i prompty wieloujęciowe.

Kling 4.0 Flash w skrócie

Kling 4.0 Flash w PoYo
TwórcaKuaishou (Kling AI)
ID modelu w APIkling-4.0-flash
Strona modelu/pl/models/kling-4-0-flash
TrybyTekst na wideo, obraz na wideo (jedna klatka początkowa), wideo z referencji, edycja wideo
Długość klipu3–20 sekund, pełne sekundy; domyślnie 5
Rozdzielczość720p (8-bitowy SDR, według Kling)
Proporcje obrazu16:9 (domyślnie), 9:16, 1:1, 21:9, auto
ReferencjeDo 10 obrazów, 5 wideo i 7 obiektów, łącznie 15 elementów
Budżet wideo wejściowegoWszystkie wideo źródłowe, referencyjne i obiektów łącznie do 20 sekund
Długość promptuDo 26 000 znaków
Cena$0.094/s · $0.063 za rozliczaną sekundę przy wideo na wejściu

Czym jest Kling 4.0 Flash?

Kling 4.0 Flash to nastawiony na szybkość członek rodziny wideo Kling 4.0 od Kuaishou. Własny przewodnik Kling opisuje go jako model do częstego tworzenia, łączący „szybkie generowanie ze świetną relacją ceny do jakości”, i wymienia klipy 3–20-sekundowe w 720p z trybami tekst na wideo, obraz na wideo i Omni Reference. Pełny model Kling 4.0 sięga w PoYo do 30 sekund i 1080p oraz dodaje klatki początkowe i końcowe oraz prompty wieloujęciowe.

„Kling 4 Flash” i „Kling 4.0 Flash” to ten sam model. W PoYo slug strony to kling-4-0-flash, a ID modelu w API to kling-4.0-flash, z kropką.

Używaj Flash tam, gdzie skala i czas realizacji liczą się bardziej niż maksymalna rozdzielczość: klipy do social mediów, testy hooków i formatów, zapętlone ujęcia produktów, prewizualizacja i rundy szkiców przed finalnym renderem.

Klip Kling 4.0 Flash w 720p: dwóch mistrzów sztuk walki toczy sparing w nasłonecznionym drewnianym dojo. Przykład ze strony modelu w PoYo.

Jedno ID modelu, cztery tryby

PoYo wybiera tryb na podstawie pól wewnątrz input:

TrybWyślijUwagi
Tekst na wideopromptWybierz aspect_ratio
Obraz na wideoimage_urls z dokładnie jednym obrazemprompt jest opcjonalny; obraz początkowy wyznacza kadr
Wideo z referencjireference_image_urls, reference_video_urls i/lub kling_elementsOpcjonalna klatka początkowa w image_urls wlicza się do limitu 10 obrazów
Edycja wideovideo_url + promptDodaj obrazy referencyjne, do 4 wideo referencyjnych i obiekty; kadr jest zgodny z wideo źródłowym

Priorytet jest stały: video_url wybiera edycję, każde pole referencyjne wybiera wideo z referencji, samo image_urls wybiera obraz na wideo, a sam prompt — tekst na wideo.

Parametry żądania

model i callback_url znajdują się na najwyższym poziomie; wszystkie pozostałe pola trafiają do input.

PoleTypWartości i limityDomyślnie
modelstringkling-4.0-flashWymagane
callback_urlstringPubliczny URL, który otrzymuje żądanie POST, gdy zadanie się zakończy lub nie powiedzie—
promptstring1–26 000 znaków; wymagany przy tekście, referencjach i edycji; opcjonalny przy obrazie na wideo—
durationinteger3–205; przy edycji długość źródła
resolutionstring720p720p
aspect_ratiostringauto, 16:9, 9:16, 1:1, 21:9 (tryby tekstu i referencji)16:9
image_urlsarrayDokładnie jeden obraz początkowy—
reference_image_urlsarrayDo 10 obrazów—
reference_video_urlsarrayDo 5 wideo (4 przy edycji), każde 3–20 sekund—
kling_elementsarrayDo 7 obiektów; każdy ma element_input_urls (2–4 obrazy, widok z przodu jako pierwszy) albo element_input_video_urls (dokładnie jedno wideo 3–8 s); maksymalnie 3 obiekty wideo—
video_urlstringWideo źródłowe do edycji, 3–20 sekund—

Wspólne limity, które warto sprawdzić przed zgłoszeniem:

  • Łącznie 15 elementów: klatka początkowa + obrazy referencyjne + wideo referencyjne + obiekty.
  • Łącznie 20 sekund wideo wejściowego: wideo źródłowe + wideo referencyjne + obiekty wideo.
  • Tagi odpowiadają kolejności w tablicach: @Image1, @Video1, @Element1. Przy edycji wideo źródłowe to @Video1, a wideo referencyjne zaczynają się od @Video2.
  • Formaty przesyłania w Playground: MP4 lub MOV, do 200 MB na wideo. Adresy URL mediów muszą być publicznymi linkami HTTP lub HTTPS.

Wyślij pierwsze żądanie

Utwórz klucz API w panelu PoYo i przechowuj go na swoim serwerze. Następnie zgłoś pięciosekundowe zadanie tekst na wideo:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0-flash",
    "input": {
      "prompt": "A ceramic mug of coffee steams on a wooden windowsill as rain streaks the glass. Slow push-in, soft morning light, clean frame free of text and logos.",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

Udane zgłoszenie zwraca code: 200 i zadanie w data:

{
  "code": 200,
  "data": {
    "task_id": "YOUR_TASK_ID",
    "status": "not_started",
    "created_time": "2026-11-14T10:30:00"
  }
}

Błędy walidacji mogą też wracać z HTTP 200 i code: 400, więc sprawdzaj pole code, a nie tylko status HTTP. 402 oznacza, że konto potrzebuje więcej kredytów.

Więcej przykładowych żądań

Obraz na wideo z jednej klatki początkowej

{
  "model": "kling-4.0-flash",
  "input": {
    "image_urls": ["https://example.com/red-panda.png"],
    "prompt": "The red panda shakes the snow off its fur, then turns toward the camera. Slow push-in, shallow depth of field.",
    "duration": 5
  }
}

Wynik obraz na wideo: panda czerwona na ośnieżonej gałęzi bambusa otrząsa śnieg i odwraca się w stronę kamery. 5 sekund, 94 kredyty. Przykład ze strony modelu w PoYo.

Wideo z referencji z obiektem

Poniższy obiekt korzysta z widoku z przodu i z boku. Prompt odwołuje się do niego jako @Element1, a do obrazu lokalizacji jako @Image1:

{
  "model": "kling-4.0-flash",
  "input": {
    "prompt": "@Element1 walks along the cliff-top path toward the lighthouse in @Image1 at golden hour. The camera tracks beside him as he stops and looks up at the lamp. Keep his face and yellow raincoat consistent with @Element1.",
    "reference_image_urls": ["https://example.com/lighthouse.png"],
    "kling_elements": [
      {
        "element_input_urls": [
          "https://example.com/keeper-front.png",
          "https://example.com/keeper-side.png"
        ]
      }
    ],
    "duration": 8,
    "aspect_ratio": "9:16"
  }
}

Wynik wideo z referencji: latarnik w żółtym płaszczu przeciwdeszczowym i czerwonej czapce idzie ścieżką na klifie w stronę latarni w złotej godzinie; scenę zbudowano z obrazu lokalizacji i obiektu z dwóch widoków. 8 sekund, 9:16, 150,4 kredytu. Przykład ze strony modelu w PoYo.

Edycja istniejącego klipu

Domyślnie wynik zachowuje długość źródła:

{
  "model": "kling-4.0-flash",
  "input": {
    "video_url": "https://example.com/winter-clip.mp4",
    "reference_image_urls": ["https://example.com/spring-bamboo.png"],
    "prompt": "Edit @Video1 and change the season from winter to spring, using @Image1 as the environment reference. Keep the animal, its movements, timing and camera motion exactly as in @Video1."
  }
}

Wynik edycji: powyższy klip z pandą czerwoną na śniegu, zmieniony na wiosnę z zielonym bambusem i kwitnącymi wiśniami, przy niezmienionym ruchu pandy i kamery. 151,2 kredytu. Przykład ze strony modelu w PoYo.

Odpytuj status zadania

Zadanie możesz w każdej chwili sprawdzić po jego ID:

curl https://api.poyo.ai/api/generate/status/YOUR_TASK_ID \
  -H "Authorization: Bearer $POYO_API_KEY"

Status przechodzi od not_started do running, a następnie do finished lub failed. Ukończone zadanie zawiera wideo w data.files, z file_url i file_type: "video". Nieudane zadanie ma error_message.

Pętla w Pythonie z limitem czasu dla twojego backendu:

import os
import time
import requests

API = "https://api.poyo.ai"
HEADERS = {"Authorization": "Bearer " + os.environ["POYO_API_KEY"]}

def data_or_raise(resp):
    resp.raise_for_status()
    body = resp.json()
    if body.get("code") not in (0, 200):
        raise RuntimeError(body.get("message") or body)
    return body["data"]

task = data_or_raise(requests.post(f"{API}/api/generate/submit", headers=HEADERS, json={
    "model": "kling-4.0-flash",
    "input": {
        "prompt": "A paper lantern drifts up over a night market. Slow tilt up, warm light, glowing stalls below.",
        "duration": 5,
        "aspect_ratio": "9:16",
    },
}, timeout=60))
task_id = task["task_id"]
print("task:", task_id)

deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    status = data_or_raise(requests.get(f"{API}/api/generate/status/{task_id}", headers=HEADERS, timeout=60))
    if status["status"] == "finished":
        print([f["file_url"] for f in status.get("files", []) if f.get("file_type") == "video"])
        break
    if status["status"] == "failed":
        raise RuntimeError(status.get("error_message") or "generation failed")
    time.sleep(10)
else:
    print("Still running; check this task_id again later:", task_id)

Jeśli pętla przekroczy limit czasu, odpytaj później ten sam task_id; każde nowe zgłoszenie to osobny, rozliczany klip. W potokach produkcyjnych callback_url na najwyższym poziomie zastępuje odpytywanie webhookiem.

Koszt klipu w Kling 4.0 Flash

PoYo rozlicza Flash za sekundę z kredytów pay-as-you-go ($1 = 200 kredytów). Przy zadaniach z tekstu, obrazu i referencji obrazowych płacisz za długość wyniku według jednej stałej stawki, a obrazy referencyjne i obiekty obrazowe są w cenie.

Długość wynikuKredytyUSD
3 s56.4$0.282
5 s94$0.47
8 s150.4$0.752
10 s188$0.94
15 s282$1.41
20 s376$1.88

Dla porównania ten sam 5-sekundowy klip w Kling 4.0 w 720p kosztuje $0.7125, więc Flash jest o około 34% tańszy.

Z wideo na wejściu

Gdy żądanie zawiera wideo źródłowe, wideo referencyjne lub obiekty wideo, stawka wynosi 12,6 kredytu ($0.063) za rozliczaną sekundę, gdzie:

rozliczane sekundy = długość wyniku + max(łączna długość wideo wejściowego zaokrąglona w górę, długość wyniku)

ZadanieRozliczane sekundyKredytyUSD
Klip 5 s prowadzony jednym 4-sekundowym wideo referencyjnym5 + max(4, 5) = 10126$0.63
Klip 10 s prowadzony 12 s wideo referencyjnego10 + max(12, 10) = 22277.2$1.386
Edycja klipu 8 s z zachowaniem długości8 + max(8, 8) = 16201.6$1.008
Edycja klipu 15 s z jednym 5-sekundowym wideo referencyjnym15 + max(20, 15) = 35441$2.205

Ułamkowe długości wejścia są zaokrąglane w górę. Wiosenna edycja na stronie modelu korzystała ze źródła trwającego nieco ponad 5 sekund, które liczono jako 6: 6 + 6 = 12 rozliczanych sekund, czyli 151,2 kredytu. Budżetowanie dla całej rodziny Kling 4.0 opisuje nasz przewodnik po cenach API Kling 4.0.

Wskazówki do promptów dla Kling 4.0 Flash

  1. Jedna ciągła akcja na klip. Krótkie klipy są najstabilniejsze, gdy prompt prowadzi jeden obiekt przez jeden moment: „odwraca się, zatrzymuje, spogląda w górę”. Historie z kilkoma momentami zostaw na klipy 10–20-sekundowe i pisz je według schematu: wprowadzenie, akcja, rozwiązanie.
  2. Nazwij ruch kamery. Najazd, orbita, ujęcie z prowadzeniem, ruch w górę. Opisz go w osobnym zdaniu, aby wyróżniał się na tle szczegółów wizualnych.
  3. Opisz światło i fakturę. Pora dnia, kierunek światła i materiały, takie jak mokre szkło, szczotkowany metal czy futro, nadają klipowi w 720p wyraźny, spójny wygląd.
  4. Otaguj każde wejście. Odwołuj się do mediów jako @Image1, @Video1 i @Element1 w kolejności z tablic i napisz, za co każde odpowiada: tożsamość, lokalizację, ruch czy styl.
  5. Starannie buduj obiekty. Widok z przodu umieść jako pierwszy, dodaj 1–3 dodatkowe ujęcia z innych stron i trzymaj się prostego tła. Dla obiektu wideo użyj jednego wyraźnego klipu 3–8-sekundowego.
  6. Edycje zaczynaj od „Edit @Video1”. Potem opisz zmianę i wymień, co ma pozostać bez zmian: tożsamość, ruch, timing i trasę kamery.
  7. Poproś o czysty kadr. Dodaj „clean frame, free of text and logos”, jeśli planujesz później dodać napisy lub branding.
  8. Dopasuj długość do pomysłu. 5-sekundowy klip mieści jeden gest lub odsłonięcie. 15–20 sekund zostaw na akcje, które potrzebują miejsca, bo koszt rośnie z każdą sekundą.

Reżyserowana praca kamery w Kling 4.0 Flash: kamera okrąża samochód wyścigowy driftujący w dymie pod neonami, a potem zatrzymuje się na jego przodzie. Przykład ze strony modelu w PoYo.

Więcej wzorców promptów, które działają w całej rodzinie, znajdziesz w przewodniku po promptach Kling 4.0 i przewodniku po Omni Reference.

Kling 4.0 Flash vs Kling 4.0 w skrócie

Kling 4.0 FlashKling 4.0
ID modelukling-4.0-flashkling-4.0
Rozdzielczość720p720p, 1080p
Długość klipu3–20 s3–30 s
KlatkiJedna klatka początkowaKlatki początkowe i końcowe
Prompty wieloujęcioweJeden prompt na klipmulti_prompt z długością każdego ujęcia
Referencje przy edycjiObrazy, do 4 wideo referencyjnych i obiektyObrazy i obiekty obrazowe
Cena w 720p, zadania z tekstu i obrazu$0.094/s$0.1425/s

Szkicuj we Flash, a wybrany kierunek przenieś do Kling 4.0, gdy wersja finalna wymaga 1080p, klatki końcowej lub więcej niż 20 sekund. Pełne porównanie znajdziesz w artykule Kling 4.0 vs Flash. Jak Flash wypada na tle szybkich modeli wideo Google, opisuje artykuł Gemini Omni 1.2 Flash vs Kling 4.0 Flash vs Veo 3.1.

Najczęstsze pytania

Jakie jest ID modelu Kling 4.0 Flash?

kling-4.0-flash. W adresie URL używany jest slug strony kling-4-0-flash. W treści żądania wyślij "model": "kling-4.0-flash".

Ile kosztuje Kling 4.0 Flash?

W PoYo 18,8 kredytu ($0.094) za sekundę wyniku przy zadaniach z tekstu, obrazu i referencji obrazowych: $0.47 za 5 sekund, $0.94 za 10 sekund i $1.88 za 20 sekund. Gdy na wejściu jest wideo, stawka wynosi 12,6 kredytu ($0.063) za rozliczaną sekundę.

Czy Kling 4 Flash jest darmowy?

Kling 4.0 Flash działa w PoYo w ramach kredytów pay-as-you-go, bez subskrypcji. Każde uruchomienie jest rozliczane z salda kredytów, a Playground pokazuje szacunek kredytów przed generowaniem, więc możesz najpierw sprawdzić koszt promptu, zestawu referencji lub edycji.

Jak długie mogą być wideo z Kling 4.0 Flash?

Od 3 do 20 sekund na generowanie, w pełnych sekundach. Domyślnie 5 sekund, a edycje zachowują długość źródła, chyba że ustawisz duration.

Kiedy przejść z Flash na Kling 4.0?

Flash jest stworzony do klipów w 720p z promptu, klatki początkowej lub referencji. Do 1080p, klatki końcowej, multi_prompt lub klipów do 30 sekund użyj Kling 4.0 z tymi samymi polami żądania.

Czy Kling 4.0 Flash jest szybszy od Kling 4.0?

Kling opisuje Flash jako swój szybszy poziom, stworzony do częstego tworzenia i szybkich iteracji. Czas generowania zależy od długości klipu i bieżącego obciążenia, więc zmierz czas kilku własnych promptów.

Czy mogę używać tego samego klucza do innych modeli wideo?

Tak. Klucz PoYo, który obsługuje Kling 4.0 Flash, obsługuje też Kling 4.0, Gemini Omni 1.2 Flash, Veo 3.1 i inne modele, przez te same endpointy zgłaszania i statusu oraz jedno saldo kredytów.

Czy mogę otrzymać webhook, gdy wideo będzie gotowe?

Tak. Dodaj callback_url na najwyższym poziomie, a PoYo wyśle na ten adres żądanie POST, gdy zadanie się zakończy lub nie powiedzie. Endpoint statusu możesz nadal w każdej chwili odpytać z tym samym task_id.

Share: