Claude Opus 5.5 jest już dostępny w SeedRouter

Samouczek Kling Image 4.0 Long Image

Twórz strony WWW i karty produktów 2K w Kling Image 4.0 Long Image. Zobacz dwa realne przebiegi PNG, przykłady cURL, odpytywanie zadań i aktualny cennik.

Czytaj jako Markdown

Standardowe modele obrazów tworzą po jednym kadrze naraz. Kiedy prosisz je o kartę produktu albo całą stronę premierową, kończysz z sześcioma oderwanymi od siebie banerami i walczysz w edytorze graficznym z rozjechanymi marginesami, zmieniającymi się fontami i niespójną skalą produktu. Kling Image 4.0 Long Image działa inaczej: pojedyncze żądanie API zwraca jeden ciągły, pionowy plik PNG ułożony od góry do dołu, o stałej szerokości 1K (1024 px) lub 2K (2048 px) i wysokości dopasowanej do sekcji z briefu.

19 listopada 2026 r. uruchomiliśmy dwa zadania 2K przez endpoint /v1/images/generations w SeedRouter, aby sprawdzić oba tryby na realistycznych briefach produkcyjnych. Pierwszy przebieg wykorzystał tryb webpage z samego tekstu i zwrócił stronę premierową o wymiarach 2048 × 16 385 px dla wymyślonej marki słuchawek studyjnych (17 MB, 169 s). Drugi przebieg użył trybu ecommerce w długości medium z dwoma istniejącymi zdjęciami biżuterii i wygenerował kartę produktu o wymiarach 2048 × 19 533 px (25 MB, 261 s). Poniżej możesz obejrzeć oba pełne widoki, przetestować dowolny z tych briefów w Playground Kling Image 4.0 Long Image i sprawdzić dokładne stawki w tabeli na końcu artykułu.

Wybierz ecommerce albo webpage, zanim napiszesz pierwszą linijkę

Pole settings.skill jest wymagane i zmienia nie tylko gramatykę wizualną układu, lecz także zestaw parametrów akceptowanych przez API. Traktuj te dwa tryby jak osobne kontrakty, a nie kosmetyczne presety stylu.

Wybierz ecommerce, gdy masz już gotowe zdjęcia produktu i potrzebujesz pionowej karty produktu (PDP) do sklepu lub na marketplace. W trybie ecommerce musisz przekazać w contents od jednej do trzech pozycji refer_image, a pionowy budżet sekcji regulujesz polem settings.length (short, medium lub long, domyślnie medium). Żądania bez zdjęć referencyjnych produktu są odrzucane przed naliczeniem opłaty.

Wybierz webpage, kiedy projektujesz landing page marki, stronę premierową albo redakcyjny układ WWW. W trybie webpage referencje są opcjonalne: możesz uruchomić generowanie z samego tekstu albo dodać maksymalnie jeden style_refer_image (paleta i rytm siatki) oraz maksymalnie jeden subject_refer_image (główny obiekt na stronie). Nie wysyłaj refer_image ani settings.length w trybie webpage — oba pola należą wyłącznie do żądań ecommerce i ich pomieszanie wywoła błąd walidacji.

Ustawienie lub wejścieTryb ecommerceTryb webpage
settings.skill"ecommerce" (wymagane)"webpage" (wymagane)
settings.length"short", "medium" (domyślnie) lub "long"Pomiń całkowicie
settings.resolution"1k" (szerokość 1024 px) lub "2k" (szerokość 2048 px)"1k" (szerokość 1024 px) lub "2k" (szerokość 2048 px)
Pozycje refer_imageWymagane: od 1 do 3 publicznych URL JPEG/PNGNiedozwolone
style_refer_image / subject_refer_imageNiedozwoloneOpcjonalnie: maks. po 1 szt.

Żaden tryb nie obsługuje rozdzielczości 4k, generowania serii (n) ani wyboru proporcji. Każde udane zadanie zwraca dokładnie jeden adres URL pionowego pliku PNG w polu output.data[0].url.

Przebieg 1: Strona WWW 2K z samego tekstu (2048 × 16 385)

Czterokolumnowy przegląd strony WWW Solstice Audio S-01 Reference Planar o wymiarach 2048 na 16 385

Powyżej widać wszystkie cztery pionowe ćwiartki naszego przebiegu webpage 2K zestawione obok siebie. Brief opisywał ciemnoobsydianową, szwajcarsko-industrialną stronę premierową otwartych słuchawek planarnych S-01 Reference Planar: minimalistyczny górny pasek, ujęcie hero w trzech czwartych, trzykolumnowy pas wyróżników akustycznych, przekrój obróbki CNC, tabelę specyfikacji technicznej z konkretnymi parametrami elektrycznymi oraz stonowaną stopkę.

Warto przyjrzeć się temu, co utrzymało spójność w jednym ciągłym przebiegu. Na wysokości 16 385 pikseli grafitowe tło, szeryfowe nagłówki i geometria szczotkowanego aluminium pozostały jednolite od paska nawigacji aż po pasek pięciu wariantów kolorystycznych i tabelę specyfikacji. Wszystkie podane parametry techniczne wyrenderowały się czytelnie (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). Inspekcja pełnego PNG w powiększeniu 100% ujawniła jeden drobiazg: brief prosił o jasny alabastrowy pas za tabelą specyfikacji, tymczasem model zostawił tabelę na ciemnym łupku, a jaśniejszy szary pas umieścił niżej — w sekcji zapisu na newsletter. Jeśli dokładna zmiana koloru tła w konkretnej sekcji jest krytyczna przy przekazaniu do wdrożenia, traktuj taki plik jako kierunek wizualny i odtwórz dany pas w HTML na bazie wygenerowanych zdjęć.

Pisanie dobrego briefu dla trybu webpage bardziej przypomina makietę wireframe niż prompt do pojedynczego zdjęcia. Na początku podaj globalne tokeny wizualne (kod hex tła, faktury powierzchni, kolor akcentowy, dyscyplinę siatki), a potem ponumeruj każdą sekcję od góry do dołu z konkretnymi nagłówkami i liczbami. Ogólnikowe opisy szybko prowadzą do wypełniaczy tekstowych.

curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-image-4-0-long-image",
    "contents": [{
      "type": "prompt",
      "text": "Design a vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
    }],
    "settings": {
      "skill": "webpage",
      "resolution": "2k"
    }
  }' -o solstice-task.json
jq -er '.id' solstice-task.json

Zwróć uwagę, że w tym żądaniu całkowicie pomijamy settings.length, a tablica contents zawiera wyłącznie wpis prompt. Pełny kontrakt parametrów znajdziesz w dokumentacji API Kling Image 4.0 Long Image. [1]

Przebieg 2: Karta produktu e-commerce 2K z dwiema referencjami (2048 × 19 533)

Czterokolumnowy przegląd karty produktu e-commerce złotego kolczyka botanicznego o wymiarach 2048 na 19 533

W drugim przebiegu zmieniliśmy settings.skill na "ecommerce", ustawiliśmy settings.length na "medium", zostawiliśmy resolution na "2k" i dołączyliśmy dwa gotowe zdjęcia biżuterii jako pozycje refer_image: zbliżenie makro na rzeźbiony złoty kolczyk w kształcie storczyka z identyfikatorem id: "earring" oraz portret redakcyjny w oranżerii przedstawiający kobietę w tym samym kolczyku z id: "model".

W prompcie odwoływaliśmy się do tych materiałów przez @earring i @model w opisach poszczególnych sekcji. API automatycznie mapuje nazwane identyfikatory na indeksy pozycyjne, więc nie trzeba ich ręcznie liczyć. Każde zdjęcie referencyjne musi być publicznym adresem URL pliku JPEG lub PNG o rozmiarze do 30 MB, boku co najmniej 300 px oraz proporcjach mieszczących się między 2:5 a 5:2.

Opisana sekcja Craft And Beauty z karty produktu e-commerce w rozdzielczości 2K

Ten pojedynczy przebieg medium 2K wygenerował 19 533 piksele w pionie i sześć kompletnych modułów e-commerce: produktową sekcję hero na tle szampańskiego jedwabiu, poetycki pas inspiracji projektowej, czysty packshot zestawiony z sześciowierszową tabelą danych produktu (Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), portret On The Ear wierny zdjęciu @model, siatkę sześciu ujęć (Front, Side, Back, Core Detail, Hook Detail, Profile) oraz powiększony wyżej schemat detali Craft And Beauty.

Przegląd pliku w pełnej rozdzielczości wyłapał też jeden mankament, o którym warto pamiętać przed publikacją wygenerowanych kart PDP prosto w katalogu sklepu. Choć tabela specyfikacji zachowała dokładną nazwę Phalaenopsis No. 4 Drop Earring, a wszystkie etykiety na schemacie były bezbłędne, górny baner hero skrócił Botanical Series do BOTA SERIES i BOTA — Drop Earring zamiast wypisać wskazaną nazwę marki L'ORCHIDÉE. To typowe zachowanie przy renderowaniu tekstu na długich stronach: krótkie etykiety i wiersze specyfikacji są bardzo stabilne, natomiast stylizowane, wersalikowe logotypy w hero potrafią się zniekształcić. Zawsze kontroluj nagłówek hero w pełnej szerokości, a prawnie wiążące logotypy i drobną czcionkę regulaminową nakładaj w szablonie sklepu jako wektor lub HTML.

curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-image-4-0-long-image",
    "contents": [
      {
        "type": "prompt",
        "text": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
      },
      {
        "type": "refer_image",
        "id": "earring",
        "url": "https://example.com/assets/gold-orchid-earring.png"
      },
      {
        "type": "refer_image",
        "id": "model",
        "url": "https://example.com/assets/editorial-portrait.png"
      }
    ],
    "settings": {
      "skill": "ecommerce",
      "length": "medium",
      "resolution": "2k"
    }
  }' -o orchidee-task.json
jq -er '.id' orchidee-task.json

Jeśli zamiast tego używasz referencji w trybie webpage, pamiętaj o prostej regule: przekaż style_refer_image dla kierunku estetycznego i subject_refer_image dla głównego produktu, nadaj każdemu unikalne alfanumeryczne id (od 1 do 32 znaków, bez spacji) i przywołuj je w prompcie przez @id. Nigdy nie duplikuj identyfikatorów w obrębie jednej tablicy contents.

Odpytuj zadanie cierpliwie i przygotuj się na duże pliki PNG 2K

Pionowe układy generują się wyraźnie dłużej niż zwykłe pojedyncze kadry i zwracają znacznie cięższe pliki. Traktowanie ich jak pięciosekundowego API do miniaturek to najprostsza droga do timeoutów po stronie klienta albo przypadkowego podwójnego naliczenia opłaty.

W naszych przebiegach z 19 listopada strona WWW 2048 × 16 385 skończyła się po 169 sekundach (17 MB), a średnia karta e-commerce 2048 × 19 533 po 261 sekundach (25 MB). Długie karty e-commerce 2K potrafią przekraczać siedem minut i ważyć ponad 50 MB. Zapisz identyfikator zadania od razu po odpowiedzi z POST /v1/images/generations, odpytuj GET /v1/tasks/{id} co 15–20 sekund i nigdy nie wysyłaj ponownie żądania POST tylko dlatego, że zerwała się sesja terminala lub klient przekroczył limit czasu. [2]

TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.json

Gdy status przyjmie wartość completed, wyciągnij adres URL pojedynczego pliku PNG z output.data[0].url i zapisz go strumieniowo na dysku z zapasem czasu na transfer:

IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.png

W workerach backendowych nie buforuj całego PNG w niewielkiej pamięci operacyjnej przed zapisem na dysk lub do object storage. Strumieniuj ciało odpowiedzi HTTP prosto do pliku, sprawdź wymiary przed pocięciem sekcji pod sklepy mobilne i konwertuj podglądy do WebP, zostawiając źródłowy PNG do druku lub eksportu wycinków.

Planuj budżet dla ośmiu wariantów wynikowych i zdjęć referencyjnych

Koszt Kling Image 4.0 Long Image zależy od trzech wyborów: skill (ecommerce lub webpage), length (short, medium albo long w trybie e-commerce) oraz resolution (1k lub 2k). Każdy wejściowy obraz referencyjny (refer_image, style_refer_image lub subject_refer_image) dolicza jedną opłatę za obraz wejściowy — już od pierwszego zdjęcia, bez darmowej puli.

To upraszcza strategię iteracji. Kiedy testujesz kolejność sekcji, rytm nagłówków i hierarchię kolorów dla katalogu sklepowego, zacznij od 1k w długości short lub medium, oceń pionowy przepływ treści i przejdź na 2k, gdy brief będzie dopięty. W przypadku stron WWW różnica między 1k a 2k jest na tyle nieduża, że zazwyczaj od razu opłaca się wybrać 2k, jeśli zależy Ci na ostrym drobnym druku w tabelach specyfikacji. Nasz pierwszy przebieg rozliczył się dokładnie według stawki webpage 2K, a drugi według stawki ecommerce medium 2K powiększonej o opłatę za dwa obrazy wejściowe. Nieudane żądanie nie wiąże się z opłatą. Sprawdź aktualne stawki poniżej albo przelicz własną konfigurację w kalkulatorze cen Kling Image 4.0 Long Image. [3]

Ile kosztuje Kling Image 4.0 Long Image

KategoriaCennik (USD)
Ecommerce · 1K · short0,2269 USD
Ecommerce · 2K · short0,2723 USD
Ecommerce · 1K · medium0,4538 USD
Ecommerce · 2K · medium0,5294 USD
Ecommerce · 1K · long0,7563 USD
Ecommerce · 2K · long0,8319 USD
Webpage · 1K0,5294 USD
Webpage · 2K0,5748 USD
Obraz referencyjny0,003025 USD

Najczęstsze pytania

Jak wybrać między short, medium i long w trybie ecommerce?

Policz, ile osobnych modułów faktycznie wymaga Twój produkt, zanim ustawisz length. Wariant short mieści trzy do czterech zwartych pasów, np. sekcję hero, kluczowe zalety i krótką specyfikację. Wariant medium swobodnie uniesie sześć sekcji — tak jak w powyższym przykładzie z biżuterią (hero, historia, packshot, tabela danych, zdjęcie na modelce, siatka wielu ujęć i schemat detali). Wariant long zostaw na sprzęt techniczny lub oferty wielowariantowe, w których potrzebujesz tabel porównawczych, instrukcji krok po kroku i rozpiski zawartości opakowania bez ściskania typografii.

Dlaczego moje żądanie webpage zwróciło HTTP 400?

Dwa najczęstsze błędy walidacji to wysłanie settings.length razem z skill: "webpage" oraz oznaczenie zdjęcia referencyjnego jako type: "refer_image" zamiast style_refer_image lub subject_refer_image. Oba te elementy działają wyłącznie w trybie ecommerce. Sprawdź też, czy prompt mieści się w ważonym limicie znaków (en / 166000 + non_en / 71000 <= 1, liczonym po podmianie odwołań @id) oraz czy resolution ma wartość "1k" albo "2k".

Czy gotowy plik PNG trzeba pociąć przed wdrożeniem w sklepie?

Tak. Plik PNG o wymiarach 2048 × 19 533 waży bez kompresji od 17 do 25 MB i jest zdecydowanie za ciężki, aby serwować go jako pojedynczy znacznik <img> w sieciach mobilnych. Potnij gotową stronę wzdłuż poziomych granic sekcji, skompresuj każdy pas do WebP lub AVIF z myślą o szybkim ładowaniu progresywnym, a ważne oznaczenia prawne, ceny i przyciski zakupu podmień na prawdziwy tekst HTML. Zanim zautomatyzujesz cały potok, możesz przetestować prompty i obejrzeć pełne pionowe wyniki w Playground Kling Image 4.0 Long Image.

Źródła

  1. Dokumentacja API SeedRouter dla Kling Image 4.0 Long Image
  2. Przewodnik odpytywania zadań i pobierania wyników w SeedRouter
  3. Aktualny cennik i kalkulator Kling Image 4.0 Long Image

Powiązane poradniki