Руководство по Kling Image 4.0 Long Image
Создавайте длинные веб-страницы и карточки товаров в 2K с Kling Image 4.0 Long Image: два реальных запуска, cURL-запросы, опрос задач и тарифы.
Читать в MarkdownОбычные модели изображений создают по одному кадру за раз. Когда вы просите у них карточку товара или полноценный сайт запуска, приходится генерировать шесть разрозненных баннеров, а затем сводить в редакторе разъезжающиеся отступы, скачущие шрифты и разный масштаб продукта. Kling Image 4.0 Long Image устроена иначе: один API-запрос возвращает единый непрерывный вертикальный PNG, выстроенный сверху донизу с фиксированной шириной 1K (1024 px) или 2K (2048 px) и высотой, которая зависит от секций в вашем брифе.
19 ноября 2026 года мы выполнили два запуска в разрешении 2K через конечную точку SeedRouter /v1/images/generations, чтобы проверить оба режима на реальных рабочих брифах. Первый запуск в режиме webpage работал только по тексту и вернул страницу запуска вымышленного бренда студийных наушников размером 2048 × 16 385 px (17 МБ, 169 секунд). Второй запуск в режиме ecommerce с длиной medium и двумя готовыми фотографиями ювелирного изделия вернул карточку товара размером 2048 × 19 533 px (25 МБ, 261 секунда). Ниже можно рассмотреть оба разворота во всю высоту, проверить любой из брифов в Playground Kling Image 4.0 Long Image и сверить точные ставки в таблице актуальных тарифов.
Выберите ecommerce или webpage до написания первой строки
Поле settings.skill обязательно и меняет не только визуальную грамматику макета, но и набор параметров, которые принимает API. Воспринимайте эти два режима как разные контракты, а не как косметические стилевые пресеты.
Выбирайте ecommerce, когда у вас уже есть реальные фотографии товара и нужна вертикальная карточка товара (PDP) для интернет-магазина или маркетплейса. В режиме ecommerce нужно передать от одного до трёх элементов refer_image в массиве contents, а вертикальный объём секций задаётся параметром settings.length (short, medium или long, по умолчанию medium). Запросы без фото товара отклоняются ещё до списания средств.
Выбирайте webpage, когда проектируете бренд-лендинг, страницу запуска или редакционный веб-макет. В режиме webpage референсы необязательны: можно запускать задачу только по тексту либо добавить не более одного style_refer_image для палитры и ритма сетки и не более одного subject_refer_image для ключевого объекта. Не передавайте refer_image и settings.length в режиме webpage: оба параметра относятся строго к ecommerce, и их смешение вызовет ошибку валидации.
| Параметр или ввод | Режим ecommerce | Режим webpage |
|---|---|---|
settings.skill | "ecommerce" (обязательно) | "webpage" (обязательно) |
settings.length | "short", "medium" (по умолчанию) или "long" | Не передавать |
settings.resolution | "1k" (ширина 1024 px) или "2k" (ширина 2048 px) | "1k" (ширина 1024 px) или "2k" (ширина 2048 px) |
Элементы refer_image | Обязательно: 1–3 публичных URL JPEG/PNG | Запрещено |
style_refer_image / subject_refer_image | Запрещено | Необязательно: до 1 каждого |
Ни один из режимов не принимает 4k, число вариантов (n) или соотношение сторон. Каждая успешная задача возвращает ровно один URL длинного PNG в поле output.data[0].url.
Запуск 1: макет веб-страницы 2K только по тексту (2048 × 16 385)

Выше рядом показаны все четыре вертикальные четверти нашего запуска webpage в 2K. В брифе запрашивалась тёмно-обсидиановая страница запуска в швейцарском индустриальном стиле для открытых планарных наушников S-01 Reference Planar: минималистичная верхняя панель, заглавный снимок в три четверти, полоса из трёх колонок с акустическими преимуществами, разрез фрезерованного корпуса CNC, таблица технических характеристик с реальными электрическими параметрами и сдержанный подвал.
Посмотрите, что удалось удержать за один цельный проход. На протяжении 16 385 вертикальных пикселей тёмно-угольный фон, антиквенные акцидентные заголовки и геометрия шлифованного алюминия остались согласованными от верхней навигации до полосы из пяти расцветок и таблицы спецификаций. Все запрошенные технические цифры отрендерились читаемо (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). При просмотре полного PNG в масштабе 100% заметна одна небольшая деталь: в промпте запрашивалась светлая алебастровая полоса под таблицей характеристик, однако модель оставила таблицу на тёмном сланце, а более светлую серую подложку перенесла на блок подписки ниже. Если точная смена фона секции критична для передачи в разработку, используйте результат как визуальный арт-дирекшн, а нужную HTML-секцию пересоберите поверх сгенерированных фотографий.
Составление сильного брифа для webpage ближе к описанию вайрфрейма, чем к промпту для обычной фотографии. Сначала задайте глобальные дизайн-токены (HEX фона, фактуру поверхностей, акцентный цвет, дисциплину сетки), а затем пронумеруйте каждый блок сверху вниз с конкретными текстами заголовков и точными цифрами. Расплывчатые формулировки заголовков почти всегда приводят к шаблонному тексту-заполнителю.
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Обратите внимание, что settings.length в этом запросе отсутствует, а в contents передан только элемент prompt. Полный контракт параметров доступен в справочнике API Kling Image 4.0 Long Image. [1]
Запуск 2: карточка товара 2K с двумя референсами (2048 × 19 533)

Для второго запуска мы переключили settings.skill на "ecommerce", задали settings.length значение "medium", оставили resolution на "2k" и передали две готовые фотографии ювелирного украшения как элементы refer_image: макросъёмку скульптурной золотой серьги-орхидеи с тегом id: "earring" и портрет женщины в оранжерее в той же серьге с тегом id: "model".
В промпте мы ссылались на эти два исходника через @earring и @model внутри описания каждой секции. API автоматически сопоставляет ваши именованные ID с позиционными ссылками, поэтому считать индексы вручную не нужно. Каждое референсное фото должно быть доступно по публичному URL в формате JPEG или PNG, весить до 30 МБ, иметь сторону не менее 300 px и соотношение сторон от 2:5 до 5:2.

Один запрос средней длины в 2K сгенерировал 19 533 вертикальных пикселя с шестью полноценными модулями карточки товара: первый экран на тёплом шёлке шампань, поэтический блок о вдохновении дизайна, чистую студийную обтравку рядом с таблицей характеристик из шести строк (Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), портрет On The Ear с сохранением образа @model, сетку из шести ракурсов (Front, Side, Back, Core Detail, Hook Detail, Profile) и аннотированную схему с выносками Craft And Beauty, показанную крупно выше.
Проверка в полном разрешении выявила один нюанс, который стоит учитывать перед публикацией сгенерированных карточек напрямую в рабочий каталог. Хотя в таблице характеристик точно сохранилось название модели Phalaenopsis No. 4 Drop Earring и все подписи выносок написаны без ошибок, на верхнем баннере Botanical Series сократилось до BOTA SERIES и BOTA — Drop Earring вместо запрошенного названия бренда L'ORCHIDÉE. Это характерный момент для рендера длинных страниц: короткие подписи и строки таблиц держатся стабильно, а стилизованные прописные логотипы в шапке иногда искажаются. Всегда проверяйте заголовок первого экрана в полную ширину, а юридически точные логотипы и обязательные реквизиты накладывайте вектором уже в шаблоне витрины.
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Если вы используете референсы в режиме webpage, держите в уме простое правило: передавайте style_refer_image для визуального направления и subject_refer_image для ключевого продукта, задавая каждому уникальный буквенно-цифровой id (от 1 до 32 символов, без пробелов) и ссылаясь на него в промпте через @id. Не дублируйте ID внутри одного массива contents.
Терпеливо опрашивайте статус и закладывайте запас под тяжёлые 2K PNG
Длинные вертикальные макеты строятся заметно дольше обычных одиночных кадров и весят гораздо больше. Если обращаться с ними как с пятисекундным API для миниатюр, легко словить клиентский таймаут или случайно отправить повторный платный запрос.
В наших запусках 19 ноября веб-страница 2048 × 16 385 завершилась за 169 секунд (17 МБ), а средняя карточка товара 2048 × 19 533 — за 261 секунду (25 МБ). Длинные карточки long в 2K могут генерироваться дольше семи минут и превышать 50 МБ. Сразу сохраняйте ID задачи после ответа POST /v1/images/generations, опрашивайте GET /v1/tasks/{id} каждые 15–20 секунд и никогда не отправляйте второй POST лишь потому, что оборвалась сессия терминала или истёк таймаут клиента. [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Когда в поле status появится completed, извлеките единственный URL файла PNG из output.data[0].url и сохраните его на диск с достаточным таймаутом скачивания:
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В бэкенд-воркерах не считывайте весь PNG целиком в небольшой буфер оперативной памяти перед записью на диск или в объектное хранилище. Стримьте тело HTTP-ответа напрямую в файл, проверяйте размеры изображения перед нарезкой секций для мобильной витрины и конвертируйте веб-превью в WebP, оставляя исходный PNG для печати или экспорта фрагментов.
Планирование бюджета по восьми уровням вывода и референсам
Стоимость Kling Image 4.0 Long Image складывается из трёх параметров: skill (ecommerce или webpage), length (short, medium или long в режиме ecommerce) и resolution (1k или 2k). Каждое входное изображение-референс (refer_image, style_refer_image или subject_refer_image) добавляет оплату за один входной кадр начиная с первого фото, без бесплатной квоты.
Отсюда следует понятная стратегия черновиков. Когда вы отрабатываете порядок секций, ритм заголовков и цветовую иерархию для каталога e-commerce, сначала тестируйте макет в 1k с длиной short или medium, оценивайте вертикальный поток и только потом переходите на 2k. Для веб-страниц разница между 1k и 2k невелика, поэтому 2k обычно оправдан сразу, если в макете есть таблицы характеристик с мелким текстом. Первый наш запуск списался точно по тарифу webpage 2K, а второй — по тарифу ecommerce medium 2K плюс два входных изображения. За неудачный запрос плата не взимается. Проверьте актуальные ставки ниже или подставьте свои параметры в калькулятор стоимости Kling Image 4.0 Long Image. [3]
Сколько стоит Kling Image 4.0 Long Image
| Категория | Цены (USD) |
|---|---|
| Карточка товара · 1K · short | 0,2269 $ |
| Карточка товара · 2K · short | 0,2723 $ |
| Карточка товара · 1K · medium | 0,4538 $ |
| Карточка товара · 2K · medium | 0,5294 $ |
| Карточка товара · 1K · long | 0,7563 $ |
| Карточка товара · 2K · long | 0,8319 $ |
| Веб-страница · 1K | 0,5294 $ |
| Веб-страница · 2K | 0,5748 $ |
| Изображение-референс | 0,003025 $ |
Частые вопросы
Как выбрать между short, medium и long в режиме ecommerce?
Посчитайте, сколько самостоятельных модулей действительно нужно вашему товару, прежде чем задавать length. Режим short подходит для трёх-четырёх компактных блоков: первый экран, ключевые преимущества и краткие характеристики. Режим medium уверенно вмещает шесть секций, как в ювелирном примере выше (первый экран, история дизайна, студийная обтравка, таблица характеристик, кадр на модели, сетка ракурсов и схема с выносками). Оставляйте long для сложной техники или многовариантных SKU, где требуются сравнительные таблицы, пошаговые инструкции и разбор комплектации без тесной вёрстки.
Почему мой запрос в режиме webpage вернул HTTP 400?
Две самые частые ошибки валидации — передача settings.length вместе с skill: "webpage" и указание type: "refer_image" вместо style_refer_image или subject_refer_image. Оба этих поля разрешены исключительно в режиме ecommerce. Также убедитесь, что промпт укладывается во взвешенный лимит длины (en / 166000 + non_en / 71000 <= 1, проверяется после подстановки ссылок @id), а в resolution передано "1k" или "2k".
Нужно ли нарезать готовый PNG для рабочего интернет-магазина?
Да. Файл PNG размером 2048 × 19 533 весит 17–25 МБ и слишком тяжёл, чтобы отдавать его одним тегом <img> в мобильных сетях. Нарежьте готовый макет по горизонтальным границам секций, сожмите каждый фрагмент в WebP или AVIF для быстрой постепенной загрузки, а юридически важные знаки, цены и кнопки покупки сверстайте живым HTML-текстом. Протестировать промпты и просмотреть результат во всю высоту можно прямо в Playground Kling Image 4.0 Long Image до автоматизации конвейера.



