Claude Opus 5.5 jest już dostępny w SeedRouter

Image

Kling Image 4.0 Long Image

View Markdown

Generuj pionowe karty produktów e-commerce i projekty stron WWW w rozdzielczości 1K lub 2K za pomocą Kling Image 4.0 Long Image, a potem odpytuj zadanie po gotowy adres URL pliku PNG.

Wyślij żądanie JSON do POST /v1/images/generations z identyfikatorem modelu kling-image-4-0-long-image. Zapisz zwrócony identyfikator zadania, a następnie odpytuj GET /v1/tasks/{id}, aż pojedynczy pionowy plik PNG będzie gotowy.

Szybki przykład

To żądanie tworzy układ strony WWW w rozdzielczości 1K na podstawie samego opisu tekstowego. Zapisz klucz API w zmiennej środowiskowej SEEDROUTER_API_KEY.

curl 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 tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
    ],
    "settings": {"skill": "webpage", "resolution": "1k"}
  }'

Endpoint i nagłówki

Wyślij dane JSON na adres POST https://api.seedrouter.ai/v1/images/generations z nagłówkami Content-Type: application/json oraz Authorization: Bearer YOUR_API_KEY. Przechowuj klucz wyłącznie po stronie serwera.

Parametry

PoleTypWartości i ustawienia domyślne
modelstring, wymaganekling-image-4-0-long-image
contentsarray, wymaganeJeden element prompt oraz elementy obrazów referencyjnych zależne od wybranego trybu.
contents[].typestring, wymaganeprompt, refer_image (tylko ecommerce, wymagane 1–3), style_refer_image (tylko webpage, maks. 1) lub subject_refer_image (tylko webpage, maks. 1). Typ element nie jest obsługiwany.
contents[].textstringWymagane dla prompt. Limit dla tekstu wyłącznie po angielsku to 166 000 znaków, a dla innych języków 71 000. Tekst mieszany musi spełniać warunek english / 166000 + non_english / 71000 <= 1.
contents[].urlstringWymagane dla każdego obrazu. Publiczny adres HTTP(S) do pliku JPEG lub PNG o rozmiarze do 30 MB, boku co najmniej 300 px i proporcjach od 2:5 do 5:2.
contents[].idstringOpcjonalny identyfikator referencji, unikalny wśród wszystkich obrazów w żądaniu. W prompcie odwołuj się do niego jako @id.
settings.skillstring, wymaganeecommerce dla kart produktów lub webpage dla projektów stron WWW.
settings.lengthstringshort (~2–5 sekcji), medium (domyślnie, ~6–10 sekcji) lub long (~11–18 sekcji). Dotyczy wyłącznie trybu ecommerce; w trybie webpage jest ignorowane.
settings.resolutionstring1k (domyślnie, szerokość 1024 px) lub 2k (szerokość 2048 px). Wysokość dopasowuje się do treści. Wartość 4k nie jest obsługiwana.
options.watermark_info.enabledbooleanOpcjonalne. Obsługiwana jest wyłącznie wartość false.

Karta produktu e-commerce

Tryb ecommerce wymaga od 1 do 3 pozycji refer_image. Odwołuj się w prompcie do każdego zdjęcia przez jego pole id.

{
  "model": "kling-image-4-0-long-image",
  "contents": [
    {"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
    {"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
    {"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
  ],
  "settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}

Projekt strony WWW z referencjami stylu i obiektu

Tryb webpage przyjmuje opcjonalnie style_refer_image (maks. 1) oraz subject_refer_image (maks. 1). W tym trybie pomiń pole settings.length.

{
  "model": "kling-image-4-0-long-image",
  "contents": [
    {"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
    {"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
    {"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
  ],
  "settings": {"skill": "webpage", "resolution": "2k"}
}

Pobranie długiego obrazu

Skopiuj id z odpowiedzi POST do zmiennej TASK_ID i odpytuj zadanie, aż status zmieni się na completed lub failed. Generowanie długich obrazów trwa zazwyczaj kilka minut, szczególnie przy połączeniu long + 2k.

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Po zakończeniu odczytaj output.data[0].url. Każde żądanie zwraca jeden kompletny, pionowy plik PNG. Przy rozdzielczości 2k wysokie strony mogą przekraczać 50 MB, więc zaplanuj odpowiednio długi timeout pobierania oraz skalowanie w podglądzie. Zobacz dokumentację zadań i katalog błędów.

Cennik

Każde zakończone żądanie nalicza jedną stawkę wynikową (ecommerce zależnie od resolution × length albo webpage zależnie od resolution) plus opłatę za obraz referencyjny dla każdego przekazanego zdjęcia wejściowego (wliczając pierwsze). Nieudane żądanie nie wiąże się z opłatą. Sprawdź aktualne stawki.

Błędy i wskazówki

Nieprawidłowe żądania zwracają błąd HTTP 400 jeszcze przed naliczeniem opłaty. Najczęstsze błędy walidacji to pominięcie settings.skill, wysłanie trybu ecommerce bez 1–3 adresów URL refer_image, łączenie refer_image z trybem webpage, żądanie rozdzielczości 4k lub zduplikowanie identyfikatorów referencji.

Podaj w prompcie dokładną kolejność sekcji — od banera hero aż po tabelę specyfikacji lub stopkę — i wpisuj wyłącznie zweryfikowane dane produktu, aby układ pozostał merytorycznie spójny. Sprawdź także Playground Kling Image 4.0 Long Image oraz schemat OpenAPI.