· reAPI Team
Руководство по Kling Image 4.0 Long Image
Узнай, как использовать Kling Image 4.0 Long Image на reAPI для карточек товаров ecommerce и макетов веб-страниц, с правилами режимов, ID референсов, ценами и этапами проверки.

Большинство генераторов изображений выдают тебе по одному квадратному кадру или кадру 16:9 за раз. Когда тебе нужна целая карточка товара для ecommerce или непрерывный вертикальный лендинг, склейка шести отдельных статичных кадров почти всегда ломает освещение, поля и типографику на каждом стыке. Kling Image 4.0 Long Image решает эту задачу, рендеря один цельный длинный PNG от верхнего главного экрана до футера за один запрос.[1]
Это руководство разбирает точный контракт на reAPI для обоих режимов — webpage и ecommerce, включая правила изображений-референсов, упоминания @id, планирование разрешения 1K и 2K, текущие цены reAPI за страницу по состоянию на 20 ноября 2026 года, а также проверки опроса и инспекции файлов, необходимые для длинных PNG-файлов.[2]
Краткая сводка
- Два отдельных навыка:
settings.skillобязателен в каждом вызове. Выбирайwebpageдля концептов цельных лендингов с прокруткой (от 0 до 2 необязательных референсов, не передавайsettings.length) илиecommerceдля карточек товаров (от 1 до 3 обязательных фотоrefer_imageплюс глубинаshort,mediumилиlong).[1] - Один длинный PNG на задачу: Ширина вывода фиксирована на уровне 1K (1024 px) или 2K (2048 px), а вертикальная высота подстраивается под секции в твоём брифе.
4kне поддерживается.[2] - Роли референсов нельзя смешивать:
refer_imageработает только в режимеecommerce;style_refer_imageиsubject_refer_imageработают только в режимеwebpage. Референсы элементов не поддерживаются.[2] - Оплата за страницу: По состоянию на 20 ноября 2026 года тарифы reAPI составляют от 0,2269 $ (
ecommerce,short,1k) до 0,8319 $ (ecommerce,long,2k), при этомwebpageстоит 0,5294 $ (1k) или 0,5748 $ (2k), плюс 0,003025 $ за каждое входное изображение-референс начиная с первого. Смотри актуальную таблицу цен.[3] - Учитывай длительный рендер и крупные файлы: Многосекционный рендер обычно занимает несколько минут, а длинные PNG в 2K могут превышать 50 MB. Настраивай тайм-ауты скачивания по HTTP и просмотрщики изображений соответствующим образом.[2]
Начни с одного текстового брифа webpage в 1K
Прежде чем загружать несколько фотографий товара или оплачивать длинный макет в 2K, отправь один чисто текстовый запрос webpage в Kling Image 4.0 Long Image с шириной 1K. Задача webpage в 1K позволяет проверить ритм вертикальных секций, цветовой контраст и визуальную иерархию, не тратя лишнее время на пиксели высокого разрешения или настройку референсов.
Перечисли каждую секцию в точном порядке сверху вниз внутри одного элемента prompt. Назови главный баннер, средние полосы преимуществ, любые сетки или сравнительные полосы и завершающий блок футера. Расплывчатый запрос вроде «сделай современный сайт про кофе» оставляет число секций и визуальный ритм на волю случая, тогда как пронумерованный вертикальный план даёт тебе конкретный чек-лист при проверке результата.
curl https://reapi.ai/api/v1/images/generations \
-H 'Authorization: Bearer YOUR_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. Section 1: full-bleed hero banner with warm morning light over a pour-over bar and headline space on the left. Section 2: three single-origin bean cards with origin notes and roast level tags. Section 3: brewing guide strip showing grind size, water temperature, and pour timing. Section 4: minimal footer with cafe address and opening hours."
}
],
"settings": {
"skill": "webpage",
"resolution": "1k"
}
}'Эндпоинт возвращает JSON-объект с id твоей задачи и status: "processing". Сохрани этот ID сразу же. В отличие от эндпоинтов для отдельных кадров, которые завершаются за десять секунд, непрерывный многосекционный макет рендерится дольше. Опрашивай GET /api/v1/tasks/{id} с тем же bearer-ключом, пока status не переключится на completed или failed.[4]
Выбирай режим ecommerce или webpage в Kling Image 4.0 Long Image
Каждый запрос к Kling Image 4.0 Long Image требует settings.skill. Выбор правильного режима важен, потому что каждый навык задаёт собственные типы референсов и настройки длины, а их смешивание вызывает ошибку валидации ещё до списания средств.[2]
| Правило | Режим ecommerce | Режим webpage |
|---|---|---|
| Целевой результат | Многосекционная карточка товара | Визуальный макет цельной веб-страницы |
| Допустимые типы референсов | Только refer_image | Только style_refer_image и subject_refer_image |
| Количество референсов | От 1 до 3 (обязательно) | От 0 до 1 для стиля и от 0 до 1 для объекта (оба необязательны) |
settings.length | short, medium (по умолчанию) или long | Игнорируется (не передавай в запросе) |
settings.resolution | 1k (по умолчанию) или 2k | 1k (по умолчанию) или 2k |
options.watermark_info.enabled | Только false | Только false |
Используй режим ecommerce в Kling Image 4.0 Long Image всякий раз, когда у тебя уже есть реальные фотографии товара и тебе нужна единая вертикальная карточка для интернет-магазина. Три уровня длины соответствуют ориентировочному числу секций, указанному создателем модели: short рассчитан примерно на 2–5 секций, medium — примерно на 6–10 секций, а long — примерно на 11–18 секций.[1]
Используй режим webpage в Kling Image 4.0 Long Image, когда прототипируешь брендовый лендинг, страницу запуска или редакционный микросайт, где можно начать только с текста либо объединить один визуальный референс стиля с одной фотографией главного объекта. Поскольку режим webpage определяет вертикальную глубину по списку твоих секций, а не по перечислению length, отсутствие settings.length сохраняет запросы аккуратными и соответствующими схеме.
Настраивай именованные референсы без ошибок валидации
Изображения-референсы — главный инструмент для того, чтобы реальный товар оставался узнаваемым по всей ленте Kling Image 4.0 Long Image. Каждый элемент референса в contents принимает type, публично доступный HTTP- или HTTPS-url и необязательный уникальный id. Строки Base64 и data: URI отклоняются шлюзом reAPI.[2]
Перед отправкой каждый файл референса должен пройти четыре проверки формата:
- Формат: только JPEG или PNG.
- Размер файла: не более 30 MB на изображение.
- Минимальные размеры: не менее 300 пикселей как по ширине, так и по высоте.
- Соотношение сторон: от 2:5 до 5:2.
Проверяй каждую ссылку на референс в окне браузера без авторизации перед вызовом эндпоинта. URL-адреса ресурсов, закрытые истекающими cookie панели управления, завершатся сбоем при попытке воркера рендеринга их скачать.
Пример карточки товара ecommerce
В режиме ecommerce Kling Image 4.0 Long Image передай от одного до трёх элементов refer_image и задай каждому ракурсу короткий понятный id, например front и spout. Упоминай эти имена напрямую как @front и @spout в промпте, чтобы макет знал, какая фотография задаёт главный баннер, а какая отвечает за крупный план с выносками.
{
"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 a medium ecommerce product detail page for the brushed-steel gooseneck kettle in @front. Section 1: full-bleed hero showing @front on warm travertine stone with clean headline space. Section 2: three core benefit callouts covering pour precision, balanced handle ergonomics, and stainless body durability. Section 3: close-up detail band highlighting the curved spout from @spout with flow-control annotations. Section 4: morning pour-over brewing lifestyle scene. Section 5: care instructions and verified specification list."
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}Пример референсов стиля и объекта в webpage
В режиме webpage Kling Image 4.0 Long Image отделяй художественное направление от самого товара. Прикрепи не более одного style_refer_image для задания цветовой палитры, ритма сетки и характера типографики и не более одного subject_refer_image, чтобы физический объект оставался точным. Каждый id в рамках запроса должен быть уникальным.
{
"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 tall watch launch webpage that matches the pale sandstone palette and editorial grid rhythm of @layout while showcasing @watch. Section 1: hero header featuring @watch at center-right. Section 2: three-column craft overview covering case finish, crystal clarity, and strap taper. Section 3: close-up dial and lug detail strip. Section 4: full technical specifications grid and clean minimal footer."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}Следи за взвешенным лимитом промпта при написании длинных брифов. Kling Image 4.0 Long Image принимает до 166 000 английских символов или 71 000 неанглийских символов, а смешанный текст ограничен условием english / 166000 + non_english / 71000 <= 1. Этот лимит проверяется повторно после сопоставления имён @id с позиционными маркерами, поэтому оставляй небольшой запас, если твой промпт близок к потолку.[2]
Планируй бюджет с учётом 1K, 2K и уровней длины
В отличие от стандартных генераторов статичных кадров, которые тарифицируют каждую выходную картинку, Kling Image 4.0 Long Image оценивает каждый завершённый запрос как один тариф уровня результата плюс одну плату за каждое входное изображение-референс (включая первый референс). Неудачные генерации, не выдавшие результата, автоматически возвращают зарезервированные кредиты.[2]
В таблице ниже приведены текущие тарифы reAPI по состоянию на 20 ноября 2026 года (1 кредит = 0,001 $ USD, 1 $ = 1 000 кредитов). Всегда проверяй актуальные ставки на странице цен Kling Image 4.0 Long Image перед запуском крупных партий.[3]
| Уровень | Разрешение | Тариф reAPI (проверено 20 нояб. 2026 г.) | Типичный сценарий |
|---|---|---|---|
ecommerce · short | 1k / 2k | 0,2269 $ / 0,2723 $ | Компактное описание товара на 2–5 секций |
ecommerce · medium | 1k / 2k | 0,4538 $ / 0,5294 $ | Стандартная карточка товара на 6–10 секций |
ecommerce · long | 1k / 2k | 0,7563 $ / 0,8319 $ | Полный флагманский лист товара на 11–18 секций |
webpage | 1k / 2k | 0,5294 $ / 0,5748 $ | Лендинг с полной прокруткой или макет кампании |
| Входное изображение-референс | Любое | 0,003025 $ за шт. | Списывается один раз за каждое переданное фото-референс |
Конкретный расчёт на примере тарифов от 20 ноября 2026 года: запрос ecommerce medium 2k с двумя фото товара обходится в 0,5294 $ + 2 × 0,003025 $ = 0,53545 $. При отправке reAPI резервирует ceil(0.53545 × 1000) = 536 целых кредитов, а затем при завершении рассчитывает сумму с точностью до микродолларов и возвращает дробную разницу на твой баланс.[2]
Практичный способ контролировать расходы на Kling Image 4.0 Long Image — двухэтапный процесс. Сделай черновик порядка макета и текстов секций в 1k (или ecommerce short 1k, если сначала проверяешь точность передачи товара), просмотри каждую полосу и переходи на 2k только после утверждения визуальной последовательности.
Надёжно опрашивай задачи и проверяй длинные PNG-файлы
После отправки запроса к Kling Image 4.0 Long Image опрашивай GET /api/v1/tasks/{id} с ровным интервалом, например каждые 5–10 секунд, закладывая клиентский бюджет ожидания не менее 15–20 минут для задач long + 2k. Не повторяй автоматически POST /v1/images/generations при кратковременном сбое запроса опроса: каждый новый POST создаёт новую тарифицируемую задачу.[4]
Когда status достигнет completed, прочитай единственную ссылку из output.image_urls[0] и сразу скопируй PNG в собственное хранилище. Поскольку длинные макеты в 2K могут превышать 50 MB и тянуться более чем на 15 000 пикселей по вертикали, записывай загрузку потоком на диск, а не буферизуй весь файл в памяти небольшой бессерверной функции, и проверяй результат в два прохода:
- Обзор миниатюры на всю высоту: Отдали масштаб, чтобы проверить визуальный ритм, согласованность цвета сверху донизу и чёткие границы между секциями.
- Посекционная проверка в масштабе 100 %: Проверь главный заголовок, силуэты товара, фактуры материалов, подписи выносок и нижний блок характеристик в исходном пиксельном масштабе.
Включай в свой бриф только проверенные габариты товара, условия гарантии и технические характеристики. Проверка точности текста при зуме 100 % помогает отловить искажённые цифры или пропавшие символы до того, как макет пойдёт в нарезку для витрины или фронтенд-разработку.
Часто задаваемые вопросы
Можно ли сгенерировать вертикальную страницу в 4K в Kling Image 4.0 Long Image?
Нет. Kling Image 4.0 Long Image поддерживает только вывод в 1k (ширина 1024 px) и 2k (ширина 2048 px). Запросы с указанием 4k отклоняются с ошибкой валидации ещё до резервирования кредитов. Для отдельных статичных кадров в 4K или наборов из нескольких кадров используй Kling Image 4.0.
Почему мой запрос ecommerce не прошёл валидацию при нуле референсов?
Режим ecommerce требует от 1 до 3 элементов refer_image в contents, чтобы модель могла опираться на реальные фотографии товара в каждой вертикальной секции. Если хочешь сгенерировать вертикальный макет только по тексту, задай в settings.skill значение webpage.
Можно ли объединить refer_image и style_refer_image в одном запросе?
Нет. Роли референсов строго разделены по режимам: ecommerce принимает только refer_image, а webpage принимает только style_refer_image и subject_refer_image. Playground блокирует смешивание до отправки; при прямом вызове API запрос может сначала зарезервировать кредиты, а затем завершиться асинхронной ошибкой при обработке с автоматическим возвратом зарезервированных кредитов.
Учитывается ли первое изображение-референс при тарификации?
Да. Каждое входное изображение-референс, переданное в contents, тарифицируется один раз при завершённой задаче, начиная с первого изображения. Неудачные задачи без результата автоматически возвращают зарезервированные кредиты.
Чем Kling Image 4.0 Long Image отличается от Kling Image 4.0?
Kling Image 4.0 Long Image выдаёт один цельный длинный PNG, созданный для вертикальных карточек товаров ecommerce и макетов веб-страниц. Kling Image 4.0 выдаёт статичные кадры стандартных пропорций (до 9 независимых вариантов или серию из 2–10 кадров) в 2K или 4K.
Как обрабатывать скачивание длинных PNG-файлов объёмом 50 MB?
Задай тайм-ауты HTTP-загрузки больше 60 секунд, записывай байты ответа потоком напрямую в объектное хранилище или на диск и проверяй Content-Length или размеры PNG после скачивания перед запуском скриптов нарезки изображений.
Запуск Kling Image 4.0 Long Image в продакшен
Начни с тестирования одного промпта webpage в 1k в песочнице Kling Image 4.0 Long Image, чтобы проверить ритм секций и визуальный баланс. Как только вертикальная структура совпадёт со схемой твоего магазина или кампании, зафиксируй URL-адреса референсов, следуй схеме в документации API по Kling Image 4.0 Long Image и построй воспроизводимый конвейер опроса и нарезки вокруг output.image_urls[0].
Источники
- Kling AI, Kling Image 4.0 Long Image Generation API — официальные спецификации навыков
ecommerceиwebpage, рекомендации по уровням длины и ограничения на референсы. - reAPI, документация API по Kling Image 4.0 Long Image — схема запроса, требования к HTTP(S)-референсам, взвешенные лимиты промпта, схема ответа и механика тарификации.
- reAPI, страница модели и актуальные цены Kling Image 4.0 Long Image — текущие тарифы за уровень результата и за референс по состоянию на 20 ноября 2026 года.
- reAPI, справочник API задач — асинхронный опрос задач, конечные статусы и обработка ошибок.