Введение
Загрузите фотографии товара, перечислите преимущества и получите готовую карточку. Выберите длину страницы и разрешение, подходящее вашему магазину.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Издатель | Kling |
| Дата выпуска | 17 ноября 2026 года |
| Задачи страниц | Веб-дизайн; страница товара для электронной торговли |
| Размер промпта | От 1 до 71 000 символов для обеих задач |
| Уровни разрешения | 1k (по умолчанию), 2k |
| Длина страницы товара | short, medium (по умолчанию), long |
| Количество референсов для сайта | От 0 до 3 изображений |
| Обязательные фотографии товара | От 1 до 3 изображений |
| Требования к входным изображениям | JPG или PNG; до 30 MB; не менее 300 px по каждой стороне; соотношение от 2:5 до 5:2 |
| Зафиксированный результат веб-дизайна | PNG 2048 x 16469 при 2k |
| Зафиксированный результат страницы товара | PNG 1024 x 5021 при длине short и 1k |
Ключевые возможности и особенности
Задание о керамике превратилось в полный макет страницы
Запрос Tideline Ceramics называл главный заголовок, чаши, историю мастерской и подвал. Полученный PNG 2k имел размер 2048 x 16469 и включал эти разделы. Проверьте мелкий текст перед повторным использованием столь высокой страницы.
Короткий макет на основе фото розы
Наш запрос со стабилизированной розой использовал предоставленное изображение товара, длину short и разрешение 1k. Он вернул один PNG 1024 x 5021 в виде страницы товара вокруг этой фотографии.
Задайте каждому разделу функцию и текст
Оба эндпоинта принимают промпт до 71 000 символов. Используйте объём для порядка чтения, готовых текстов и ролей референсов. Референсы сайта необязательны; странице товара нужны от одного до трёх фото.
Выбирайте длину и разрешение отдельно
Обе задачи предлагают 1k и 2k с 1k по умолчанию. Для страниц товара добавлен выбор short, medium или long. Эти настройки влияют на цену страницы, а каждое входное изображение добавляет небольшую плату.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательный параметр, до 71 000 символов. Укажите данные о товаре, преимущества и порядок модулей, ссылаясь на фотографии как @ |
image_urls | Да | Требуется от одной до трёх фотографий товара. Каждая фотография должна быть в формате JPG или PNG, весить до 30 МБ, иметь стороны от 300 px и соотношение от 2:5 до 5:2. Не менее 1 элементов · Не более 3 элементов |
page_length | Нет | Длина страницы: short, medium или long. По умолчанию medium; более длинные страницы стоят дороже. |
resolution | Нет | Уровень страницы: 1k или 2k, по умолчанию 1k. При любой длине уровень 2k стоит дороже. |
Стоимость
Каждая готовая страница оплачивается в зависимости от длины и разрешения, а каждая фотография товара добавляет небольшую плату за ввод.
| Разрешение | Page length: short | Page length: medium | Page length: long |
|---|---|---|---|
| $0.235 / изображение | $0.47 / изображение | $0.784 / изображение |
| $0.282 / изображение | $0.549 / изображение | $0.862 / изображение |
Сценарии использования
Концепции сайта гончарной мастерской
Опишите главный блок, избранные чаши, историю мастерской и часы работы. Наш запуск Tideline Ceramics вернул эти разделы в одном PNG размером 2048 x 16469; мелкий текст нужно проверить перед повторным использованием.
Макеты страниц подарочных товаров
Предоставьте фото товара и запросите главный блок, торговые аргументы, рекомендации по уходу и блок подарочного послания. Короткий запуск со стабилизированной розой вернул один PNG 1024 x 5021, построенный вокруг предоставленного фото.
Визуальное направление бренда для передачи дизайна
Используйте необязательные референсы сайта, чтобы передать палитру или предмет изображения, а в промпте укажите аудиторию и порядок разделов. Обсудите полученную страницу с командой до разработки сайта.
Торговые задания с учётом длины страницы
Разбейте проверенные сведения о товаре на модули и выберите short, medium или long. Соотнесите объём текста с этим выбором и проверьте результат на пропущенные или изменённые факты.
Руководство по промптам и практические советы
Подберите эндпоинт под задание
Для визуальной концепции сайта по тексту с необязательными референсами выберите веб-дизайн. Если у вас есть фотографии товара и проверенные торговые аргументы, используйте эндпоинт страницы товара.
Опишите страницу сверху вниз
Расположите модули в порядке чтения и приведите точные заголовки, основной текст и подписи кнопок для каждого. Объясните, что даёт каждый пронумерованный референс и как его использовать.
Выберите настройки страницы
Оба эндпоинта предлагают разрешение 1k или 2k. Для страницы товара также выберите short, medium или long; по умолчанию используется medium.
Проверьте скачанную страницу
Прочитайте изображение в удобном масштабе и сравните формулировки и утверждения о товаре с заданием. Проверьте переходы между модулями перед передачей дизайнеру или подготовкой изображения для карточки.
Постройте историю товара вокруг предоставленных фотографий
Этот эндпоинт объединяет фотографии товара и торговое задание в непрерывное изображение страницы. Используйте его, когда покупатель должен увидеть предмет, понять предоставленные аргументы и пройти информацию через последовательность модулей. Подготовьте факты о товаре вместе с фотографиями; задание должно определять, что требуется сообщить странице.
В отличие от веб-дизайна, эта задача требует фотографий товара и даёт настройку длины. Результат — плоский визуальный макет для проверки или подготовки графики карточки. Редактируемая витрина и набор отдельных файлов модулей не предоставляются.
Данные товара и настройки страницы
Подготовьте изображения и проверенные тексты до выбора длины и разрешения. Обе настройки влияют на цену страницы, а загруженные фото добавляют плату за входные данные.
| Параметр | Требование | Назначение |
|---|---|---|
prompt | Обязательная строка, от 1 до 71 000 символов | Передайте факты, аргументы и порядок модулей; ссылайтесь на фото через @image_1, @image_2. |
image_urls | Обязательный массив от 1 до 3 фото | Используйте JPG или PNG до 30 MB, не менее 300 px по каждой стороне, с соотношением от 2:5 до 5:2. |
page_length | Необязательно: short, medium или long; по умолчанию medium | Выберите длину страницы товара. |
resolution | Необязательно: 1k или 2k; по умолчанию 1k | Выберите уровень результата независимо от длины. |
Соотнесите длину страницы с объёмом сведений, которые хотите представить. Разрешение выбирайте отдельно, а полученное изображение проверяйте с учётом предполагаемого места в магазине.
Выбирайте фотографии по содержащейся информации
Покажите товар ясно и объясните вклад каждого пронумерованного изображения, например общий вид или крупную деталь. Отделяйте сведения, видимые на фото, от характеристик, предоставленных текстом. Укажите, какой ракурс представляет товар, а какой поддерживает детальный модуль, связав каждое фото с определённой частью страницы.
Составьте торговое задание
Начните с идентификации товара и проверенных фактов. Затем перечислите модули в порядке для покупателя: главный блок, предоставленные аргументы, дополнительные детали и завершающая панель. Включите уход, если у вас есть проверенные формулировки. Не просите модель выдумывать размеры, материалы или утверждения для заполнения пустого раздела.
Пишите текст, который можно проверить
Приведите заголовок и текст каждого информационного блока рядом с его разделом. Если факт неизвестен, исключите его из запрашиваемого текста. Список общих прилагательных даёт мало оснований для проверки; предоставленное утверждение о функции можно напрямую сопоставить с результатом. Ясно изложите факты, визуальное направление и порядок модулей.
Соотнесите объём содержания с длиной
Выберите short, medium или long и напишите задание под выбранный масштаб. Компактная страница может сосредоточиться на кратком представлении товара, а длинное задание — выделить место дополнительной предоставленной информации. Задайте каждому модулю отдельную цель и удалите повторяющиеся аргументы перед отправкой. Изменение разрешения — отдельное решение, которое не заменяет сокращение перегруженного текста.
Наблюдения по запуску со стабилизированной розой
Наш запрос от 18 ноября 2026 года содержал одно фото розы и просил главное изображение, три торговых аргумента, рекомендации по уходу и завершающий блок подарочного послания в янтарной палитре с цветом слоновой кости. Были выбраны short и 1k. Задание связывало фото с последовательностью от знакомства до ухода и подарка.
Ответ содержал один PNG 1024 x 5021 как короткую страницу товара вокруг предоставленного фото. Проверьте внешний вид товара во всей последовательности и сравните аргументы, уход и заключительное сообщение с исходными формулировками перед подготовкой страницы для покупателей.
Оплата и проверки перед публикацией
Проверьте текущую цену здесь для выбранной длины и разрешения. Каждая готовая страница товара оплачивается по этим двум параметрам, а каждое фото добавляет небольшую плату за входные данные. Учитывайте все предоставленные фото, а не воспринимайте обязательные изображения как бесплатные вложения.
Перед подготовкой изображения для магазина сравните показанный предмет с фотографиями, а каждое утверждение, число и указание по уходу — с фактическими данными. Проверьте отступы и порядок чтения в предполагаемом масштабе. Результат представляет собой одно изображение страницы, поэтому последующие правки текста или макета требуют редактирования изображения либо дизайнерской работы.
Когда результату подходит другое семейство
Kling описывает стандартный процесс как вариант для отдельных визуальных материалов, а серийный — для согласованных раздельных изображений. Сравните Kling Image 4.0 для отдельной товарной графики или Kling Image 4.0 Set для коллекции отдельных изображений. Оставайтесь на этом эндпоинте, если нужна непрерывная страница товара на основе ваших фото.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/image-4.0-long/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"page_length": "medium",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.













