curl-X POST 'https://pollo.ai/api/platform/v1/generation/kling-ai/kling-v3-image/image'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "aspectRatio": "1:1", "resolution": "1K" }}'
Opcjonalnie dołącz webhookUrl, aby otrzymać wywołanie zwrotne w przypadku powodzenia lub niepowodzenia zadania.
Opcjonalne pole żądania
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","aspectRatio":"1:1","resolution":"1K"},"webhookUrl":"https://example.com/webhooks/pollo"}
Schemat
Pola wejściowe dla wybranego punktu końcowego i trybu.
Pole
Typ
Wymagany
Opis
prompt
string
Tak
Text prompt describing the content to generate.
aspectRatio
string
NIE
Output aspect ratio, as width:height (e.g. 16:9).
resolution
string
NIE
Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive.
Błędy
Typowe publiczne kody odpowiedzi API.
400
Nieprawidłowe dane wejściowe lub ograniczenie modelu
Przekaż do Kling 3.0 kilka obrazów referencyjnych, a utrzyma spójność jednej postaci, stroju i stylu graficznego w każdej klatce, dzięki czemu świetnie nadaje się do zestawów obrazów, które muszą do siebie pasować.
Dzięki Kling Image 3.0 w Pollo API deweloperzy mogą dodać do swoich aplikacji generowanie tekst-na-obraz, edycję na podstawie pojedynczej referencji oraz kompozycję wielu obrazów, renderując do 2K w proporcjach od ultraszerokiego 21:9 po pionowe 9:16.
Kluczowe funkcje API Kling Image 3.0
Kompozycja wielu obrazów
Połącz kilka obrazów referencyjnych w jednym żądaniu, aby postać, produkt i sceneria mogły zostać scalone w jedną spójną scenę zamiast osobnych renderów.
Spójność postaci i stylu
Powtarzające się obiekty zachowują twarz, ubiór i wygląd między kolejnymi generacjami, co pozwala tworzyć powiązaną sekwencję zamiast paczki niepowiązanych, jednorazowych obrazów.
Szeroki zakres proporcji
Wynik obejmuje panoramy ultraszerokie 21:9, standardowe proporcje poziome i pionowe, kwadrat oraz pionowe 9:16, więc jeden model wystarcza do banerów, plakatów i formatów mobile-first.
Szczegółowość 2K
Renderowanie osiąga rozdzielczość 2K, zachowując drobne tekstury na twarzach, tkaninach i typografii, dzięki czemu obrazy nadają się do układów drukowanych i formatów wielkoformatowych bez skalowania w górę.
Edycja prowadzona referencją
Połącz prompt z istniejącym obrazem, aby zmienić jego styl, rozszerzyć go lub zaaranżować na nowo, zyskując precyzyjną kontrolę nad ustaloną kompozycją zamiast zaczynać każdy pomysł od zera.
Zastosowania API Kling Image 3.0
Klatki storyboardu: Wygeneruj serię paneli z tym samym protagonistą i otoczeniem — przydatne w narzędziach do prewizualizacji i aplikacjach do planowania ujęć.
Ilustrowane książki i panele komiksowe: Zachowaj spójny wygląd powracającej postaci między stronami, aby platformy ilustracyjne mogły tworzyć konsekwentną sztukę sekwencyjną.
Arkusze postaci do gier: Renderuj bohatera z wielu kątów i w różnych strojach, przy zachowaniu stałej twarzy i proporcji na potrzeby pipeline’ów projektowych.
Kompozycje produkt-w-scenerii: Połącz obraz produktu z referencją modela lub otoczenia w jedno zaaranżowane ujęcie dla kreatorów listingów e-commerce.
Concept art i grafika środowiskowa: Zamień rozbudowane opisy scen w szczegółowe lokacje i rekwizyty do workflowów worldbuildingu i projektowania poziomów.
Zestawy obrazów marki: Twórz spójne serie materiałów marketingowych, które dzielą paletę, temat i układ, dla narzędzi automatyzacji kampanii.
Restylizacja referencji: Weź przesłane zdjęcie i wyrenderuj je ponownie w nowym stylu lub oświetleniu dzięki edycji obraz-na-obraz.
Jak używać API Kling Image 3.0
Pobierz klucz API: Utwórz konto Pollo API i wygeneruj klucz API w panelu deweloperskim.
Wybierz model: Wysyłaj żądania do endpointu obrazowego Kling 3.0 pod adresem /generation/kling-ai/kling-v3-image/image.
Dodaj dane wejściowe: Podaj prompt dla tekst-na-obraz, dodaj imageUrl dla edycji z pojedynczą referencją albo przekaż tablicę images dla kompozycji wielu obrazów, a następnie ustaw aspectRatio i resolution (1k lub 2k).
Generuj i pobierz: Wyślij zadanie, odpytywaj zwrócone taskId i status, a po powodzeniu pobierz gotowy obraz.
Dobre praktyki promptowania dla API Kling Image 3.0
Jasno opisz temat, kadr i relację z referencją. Przy łączeniu obrazów określ, co wnosi każda referencja, aby model wiedział, który element zachować, a który zmienić.
Prosta formuła promptu
Temat i jego cechy definiujące + co wnosi każda referencja + kompozycja i kadrowanie + styl i oświetlenie + intencja proporcji
Na co warto zwrócić uwagę
Zakotwicz postać: Nazwij cechy tożsamości, które mają zostać zachowane, np. włosy, ubiór czy wiek, aby spójność utrzymała się w całej serii.
Przypisz każdą referencję: Przy użyciu wielu obrazów określ, który jest tematem, produktem lub tłem, aby uniknąć błędnych połączeń.
Kadruj świadomie: Wybierz proporcje odpowiednie do zastosowania końcowego, bo 21:9 i 9:16 zmieniają kompozycję bardziej niż zwykłe przycięcie.
Pisz gęste prompty: Model dobrze czyta długie, szczegółowe opisy, więc poświęć słowa na układ, materiały i nastrój zamiast jednej ogólnej linijki.
Rezerwuj 2K na detale: Wybieraj 2K, gdy liczy się tekstura lub typografia, a 1K do szybszych szkiców podczas iteracji nad wyglądem.
Przykładowe prompty
Sekwencyjny panel książki obrazkowej
"Ciekawska rudowłosa dziewczynka w żółtym płaszczu przeciwdeszczowym klęczy o zmierzchu przy świecącym oczku pływowym i ogląda rozgwiazdę. Delikatna ilustracja akwarelowa, ciepłe światło kontrowe, łagodna głębia ostrości, kadr 4:3 dopasowany do poprzedniej strony książki obrazkowej."
Kompozycja produktu z wieloma referencjami
"Umieść sneaker z pierwszego obrazu na modelce z drugiego obrazu, zasznurowany i noszony, gdy siedzi na betonowych schodach. Naturalne, pochmurne światło, styl katalogu editorialowego, ostry fokus na produkcie, pion 3:4 do listingu."
Obrót postaci do gry
"Stoicki pustynny zwiadowca z blizną na szczęce, znoszonym skórzanym płaszczem pokrytym pyłem i mosiężnym kompasem, pokazany w pozie trzy czwarte od przodu. Spójna twarz i strój, malarski styl concept art, neutralne tło studyjne, kadr arkusza postaci 2:3."
Ultraszeroka koncepcja środowiska
"Opuszczona szklarnia odzyskana przez pnącza, rozbite panele szkła rozrzucają popołudniowe światło po omszałych kamiennych ścieżkach i zardzewiałych donicach. Szczegółowa grafika środowiskowa, warstwowa głębia, chłodna zielona paleta, panorama 21:9 do ujęcia otwierającego."
Kling Image 3.0 vs Seedream 4.0 vs GPT Image 1
Możliwość
Kling Image 3.0
Seedream 4.0
GPT Image 1
Kompozycja wielu obrazów
✅ Łączenie wielu referencji w jednym żądaniu
✅ Silne mieszanie referencji
✅ Obsługuje wiele wejść
Spójność postaci między klatkami
✅ Utrzymuje obiekt w całej serii
✅ Dobre zachowanie obiektu
✅ Niezawodny, mniej nastawiony na serie
Maksymalna rozdzielczość
Do 2K
Do 4K
Wysoka, zarządzana przez model
Zakres proporcji
21:9 do 9:16, osiem proporcji
Szeroki zakres
Stały zestaw rozmiarów
Długość promptu
Długie, szczegółowe prompty
Długie prompty
Długie prompty
Zalecane do
Spójnych sekwencyjnych zestawów obrazów
Edycji referencji w wysokiej rozdzielczości
Renderowania tekstu i edycji konwersacyjnych
Dlaczego wybrać API Kling Image 3.0?
Kling Image 3.0 pasuje do produktów, które potrzebują powiązanych obrazów, a nie odizolowanych — utrzymuje spójność postaci i stylu w storyboardach, panelach książkowych, arkuszach postaci i zestawach kampanii.
Przez Pollo API uzyskujesz dostęp do Kling Image 3.0 jednym kluczem API obok ponad 300 wiodących modeli obrazów i wideo, z przejrzystą dokumentacją, odpytywaniem statusu zadań i generowaniem, które kosztuje mniej niż Fal AI.
Zintegruj endpoint Kling Image 3.0, aby dostarczać spójne funkcje obrazów wieloreferencyjnych, a potem porównuj go z Seedream, GPT Image i Midjourney bez przepisywania integracji.
FAQ API Kling Image 3.0
Czym jest Kling Image 3.0?
Kling Image 3.0 to model generowania obrazów od Kling AI, obsługujący tekst-na-obraz, obraz-na-obraz i kompozycję wielu obrazów, ze szczególnym naciskiem na spójność postaci w powiązanym zestawie obrazów.
Czy API Kling Image 3.0 obsługuje wiele obrazów referencyjnych?
Tak. Możesz przekazać kilka URL-i obrazów w jednym żądaniu, dzięki czemu model połączy temat, produkt lub tło w jedną spójną scenę.
Jakie rozdzielczości i proporcje są dostępne?
Renderuje w 1K lub 2K w ośmiu proporcjach, od ultraszerokiego 21:9 przez kwadrat i pion po wertykalne 9:16, wybieranych dla każdego żądania.
Jak utrzymuje spójność postaci?
Pracując na obrazach referencyjnych i szczegółowych promptach, zachowuje cechy tożsamości, takie jak twarz, ubiór i styl, co pomaga budować panele sekwencyjne zamiast niepowiązanych obrazów.
Czy może edytować istniejący obraz?
Tak. Podaj URL obrazu wraz z promptem, aby zmienić styl, zaaranżować na nowo lub rozszerzyć obraz, uzyskując kontrolowane zmiany w ustalonej kompozycji przez obraz-na-obraz.
Dlaczego uruchamiać Kling Image 3.0 przez Pollo API?
Pollo API daje jedną integrację dla Kling Image 3.0 i ponad 300 innych modeli, z dokumentacją, śledzeniem zadań i tańszym generowaniem niż u porównywalnych dostawców.
