
Kling Image 4.0 API daje programistom dostęp do najnowszego modelu graficznego Kling AI przez jeden endpoint PoYo: wywołaj kling-4.0-image do text-to-image, edycji i serii obrazów w 2K, 4K lub 8K, a kling-4.0-long-image do pełnych projektów stron internetowych lub stron sklepów e-commerce. Ten artykuł wyjaśnia, czym jest Kling Image 4.0, do czego służy każde pole żądania, jakie obowiązują limity i ile kosztuje wywołanie w PoYo.
Czym jest Kling Image 4.0?
Kling Image 4.0 to model graficzny z rodziny Kling 4.0 od Kling AI, kreatywnej platformy AI firmy Kuaishou. Został wydany 17 listopada 2026. W poście premierowym Kling podaje, że model:
- generuje obrazy w natywnym 8K, które Kling wprowadza po raz pierwszy właśnie w tym modelu;
- tworzy do 10 obrazów z jednego promptu o spójnym stylu i treści;
- renderuje do 2,000 znaków tekstu na jednym obrazie, po angielsku, w chińskim uproszczonym, chińskim tradycyjnym, japońskim, koreańskim, hiszpańskim i portugalskim;
- tworzy długie obrazy na strony produktów w e-commerce i do projektowania stron WWW.
Kling podaje też, że model działa w Kling Creative Studio i jest dostępny przez API dla firm i programistów. PoYo dodało Kling Image 4.0 API w listopadzie 2026, bez listy oczekujących i z tym samym kluczem API, którego używasz do każdego innego modelu PoYo.
ID modeli Kling Image 4.0 API w PoYo
| ID modelu | Zastosowanie | Wynik |
|---|---|---|
kling-4.0-image | Text-to-image (bez image_urls), image-to-image z 1–10 referencjami, elementy, serie obrazów | 1–9 niezależnych obrazów albo seria 2–10, w 2K / 4K / 8K |
kling-4.0-long-image | Projekty stron skill: "webpage", strony produktów skill: "ecommerce" z 1–3 zdjęć produktu | Jeden wysoki obraz o szerokości 1024 px (1K) lub 2048 px (2K) |
Oba ID korzystają z tego samego endpointu do wysyłania zadań, tego samego odpytywania statusu i tego samego webhooka callback_url. Slug strony modelu to kling-4-0-image; ID modeli w żądaniu zawierają kropki (kling-4.0-image).
Endpoint i struktura żądania
Każde żądanie do Kling Image 4.0 API to zadanie asynchroniczne:
POST https://api.poyo.ai/api/generate/submitzAuthorization: Bearer $POYO_API_KEYi treścią JSON zawierającąmodelorazinput.- Odczytaj
data.task_idz odpowiedzi. - Odpytuj
GET https://api.poyo.ai/api/generate/status/{task_id}, ażstatusbędziefinishedlubfailed, albo przekażcallback_urlna najwyższym poziomie i odbierz POST po zakończeniu zadania.
Minimalne żądanie 4K, zgodne ze strukturą z dokumentacji:
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
Zakończone zadanie zwraca obrazy w data.files, każdy z file_url i file_type: "image". Serie obrazów wracają w kolejności. Sprawdzaj pole code w treści odpowiedzi, a nie tylko status HTTP: PoYo może zwrócić HTTP 200 z code: 400 przy błędzie walidacji. Wersję krok po kroku z cURL i Pythonem znajdziesz w przewodniku po Kling Image 4.0 API.
Pola wejściowe i limity
kling-4.0-image
| Pole | Wartości | Uwagi |
|---|---|---|
prompt | 1–50,000 znaków | Wymagane. Odwołuj się do wejść jako @Image1, @Element1 |
image_urls | 1–10 URL-i | Włącza image-to-image. Każdy obraz do 30 MB, co najmniej 300 px na bok, proporcje 0.4–2.5 |
kling_elements | do 7 elementów | Każdy {"element_input_urls": [...]} z 2–4 ujęciami, najpierw widok z przodu. Wymaga image_urls. Obrazy plus elementy ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Domyślnie auto |
resolution | 2K, 4K, 8K | Domyślnie 2K. 8K to 8192×8192 przy 1:1 |
enable_sequential | true / false | true zwraca spójną serię obrazów |
n | 1–9 (niezależne) lub 2–10 (seria) | Domyślnie 1 i 4 |
Schemat odrzuca nieznane pola, więc nie wysyłaj output_format, seed ani negative_prompt. Wynik jest w formacie PNG.
kling-4.0-long-image
| Pole | Wartości | Uwagi |
|---|---|---|
skill | webpage (domyślnie), ecommerce | Wybiera typ strony |
image_urls | 1–3 zdjęcia produktu | Wymagane dla ecommerce |
style_image_url / subject_image_url | po jednym URL-u | Tylko webpage; @StyleImage, @SubjectImage |
length | short, medium (domyślnie), long | Tylko ecommerce: około 2–5, 6–10 lub 11–18 sekcji |
resolution | 1K (domyślnie), 2K | Szerokość 1024 lub 2048 px; wysokość zależy od treści |
Każde żądanie long-image zwraca jeden obraz.
Cennik Kling Image 4.0 API w PoYo
PoYo nalicza opłaty za każdy wygenerowany obraz (1 kredyt = $0.005). Kredyty są pobierane tylko wtedy, gdy zadanie zakończy się sukcesem.
| Żądanie | Kredyty | USD |
|---|---|---|
kling-4.0-image, 2K, za obraz | 13 | $0.065 |
kling-4.0-image, 4K, za obraz | 19 | $0.095 |
kling-4.0-image, 8K, za obraz | 32 | $0.16 |
Każda pozycja image_urls i każdy element kling_elements, raz na żądanie | 1 | $0.005 |
| Długi obraz, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Długi obraz, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Długi obraz, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Długi obraz, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Długi obraz, każdy obraz w image_urls, style_image_url lub subject_image_url | 1 | $0.005 |
Szczegółowy cennik zawiera tabele dla długich obrazów i przykłady obliczeń.
Co zmierzyliśmy w dniu premiery
Zespół PoYo wykonał te żądania na produkcyjnym API 19 listopada 2026. Czasy liczone są od wysłania do wyniku z perspektywy klienta odpytującego status, więc traktuj je jako przybliżone.
| Żądanie | Wynik | Koszt | Czas |
|---|---|---|---|
kling-4.0-image, text-to-image, 16:9, 8K, n: 1 | PNG 10880×6144, około 128 MB | 32 kredyty | około 3.8 min |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | cztery obrazy 2720×1536, ten sam motocyklista, motocykl i strój od świtu do nocy | 52 kredyty | około 4.9 min |
kling-4.0-long-image, skill: "webpage", 1K | jedna strona 1024×4257 | 110 kredytów | około 1.7–2.2 min |
Dwie uwagi integracyjne z tego samego testu. Pobrane pliki były PNG z kanałem alfa (RGBA) nawet dla nieprzezroczystych obrazów, więc jawnie konwertuj je, jeśli Twój pipeline oczekuje RGB lub JPEG. Ponadto długi prompt strony po angielsku, który nie określał języka tekstów na stronie, zwrócił chiński tekst; dodanie "All text on the page is in English." rozwiązało problem. Więcej o obu kwestiach w artykule 8K i długie obrazy.
Które żądania kierować do Kling Image 4.0 API?
- Druk, billboardy i prace z intensywnym kadrowaniem, które wymagają więcej niż 4K: to jedyny model graficzny w PoYo z poziomem
8K. - Storyboardy, ujęcia produktu i prezentacje, w których jedna postać lub produkt musi wyglądać tak samo we wszystkich kadrach: użyj
enable_sequential. - Umieszczanie znanego produktu lub postaci w nowej scenie: przekaż scenę w
image_urls, a obiekt jako element z wieloma ujęciami. - Makiety landing page'y i strony produktów e-commerce jako jeden obraz:
kling-4.0-long-image.
Do szybkich szkiców w 1K–2K po najniższej cenie Kling O3 Image jest tańszy za obraz; zobacz Kling Image 4.0 API vs Kling O3 Image. Aby porównać go z modelami innych dostawców, przeczytaj Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Najczęściej zadawane pytania
Czym jest Kling Image 4.0 API?
To dostęp REST w PoYo do modelu Kling Image 4.0 od Kling AI, pod ID modeli kling-4.0-image (standardowe obrazy, edycje i serie obrazów) oraz kling-4.0-long-image (długie strony WWW i e-commerce). Oba korzystają z POST /api/generate/submit i tego samego klucza API.
Ile kosztuje Kling Image 4.0 API? 13 kredytów ($0.065) za obraz w 2K, 19 kredytów ($0.095) w 4K i 32 kredyty ($0.16) w 8K, plus 1 kredyt ($0.005) za każdy obraz referencyjny lub element, raz na żądanie. Długie obrazy kosztują od 47 do 173 kredytów za stronę. Nieudane zadania nie są rozliczane.
Czy Kling Image 4.0 API obsługuje image-to-image?
Tak. Przekaż od 1 do 10 URL-i w image_urls z kling-4.0-image i odwołuj się do nich w prompcie jako @Image1, @Image2. Dodaj do 7 kling_elements, aby zachować spójność postaci lub obiektów; obrazy plus elementy są ograniczone do 10.
Ile trwa żądanie do Kling Image 4.0 API?
W naszym teście w dniu premiery jeden obraz 16:9 w 8K zajął około 3.8 minuty, seria czterech obrazów 2K około 4.9 minuty, a strona WWW w 1K około 2 minut. Przy dużych zadaniach używaj callback_url zamiast trzymać otwarte żądanie.
Gdzie jest dokumentacja Kling Image 4.0 API? Opis pól znajdziesz w dokumentacji Kling Image 4.0 i dokumentacji długich obrazów. Strona modelu ma playground, który pokazuje JSON dla Twoich ustawień.