Image
Kling Image 4.0 Long Image
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
| Pole | Typ | Wartości i ustawienia domyślne |
|---|---|---|
model | string, wymagane | kling-image-4-0-long-image |
contents | array, wymagane | Jeden element prompt oraz elementy obrazów referencyjnych zależne od wybranego trybu. |
contents[].type | string, wymagane | prompt, 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[].text | string | Wymagane 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[].url | string | Wymagane 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[].id | string | Opcjonalny identyfikator referencji, unikalny wśród wszystkich obrazów w żądaniu. W prompcie odwołuj się do niego jako @id. |
settings.skill | string, wymagane | ecommerce dla kart produktów lub webpage dla projektów stron WWW. |
settings.length | string | short (~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.resolution | string | 1k (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.enabled | boolean | Opcjonalne. 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.
