Claude Opus 5.5 уже доступна в SeedRouter

Руководство по 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)

Четырёхколоночный обзор веб-страницы Solstice Audio S-01 Reference Planar размером 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)

Четырёхколоночный обзор карточки товара с золотой ботанической серьгой размером 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.

Аннотированная секция Craft And Beauty с выносками из карточки товара 2K

Один запрос средней длины в 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 · short0,2269 $
Карточка товара · 2K · short0,2723 $
Карточка товара · 1K · medium0,4538 $
Карточка товара · 2K · medium0,5294 $
Карточка товара · 1K · long0,7563 $
Карточка товара · 2K · long0,8319 $
Веб-страница · 1K0,5294 $
Веб-страница · 2K0,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 до автоматизации конвейера.

Источники

  1. Справочник API SeedRouter для Kling Image 4.0 Long Image
  2. Руководство SeedRouter по опросу задач и получению результатов
  3. Актуальные тарифы и калькулятор Kling Image 4.0 Long Image

Похожие руководства