Введение
Напишите один бриф на всю последовательность и получите изображения по порядку. Добавьте до десяти референсов, если персонаж, одежда или товар должны появляться на протяжении всей серии.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Издатель | Kling |
| Дата выпуска | 17 ноября 2026 года |
| Изображений на запрос | 2–10; по умолчанию 4 |
| Длина промпта | 1–21,000 символов |
| Варианты разрешения | 2k (по умолчанию), 4k, 8k |
| Соотношения сторон результата | По умолчанию auto; также 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 и 21:9 |
| Общие референсы | Необязательно; до 10 изображений |
| Форматы референсов | JPG или PNG |
| Размер файла референса | До 30 MB на изображение |
| Размеры референсов | Не менее 300 px по каждой стороне |
| Соотношение сторон референсов | От 2:5 до 5:2 |
| Основа расчёта оплаты | За каждое полученное изображение в выбранном разрешении плюс плата за ввод каждого референса |
Ключевые возможности и особенности
Роза на одной полке при двух вариантах света
Наш запрос на два изображения использовал один референс продукта и требовал сохранить продукт идентичным. Утренний результат показывает ту же розу на той же деревянной полке, что и вечерний вид. Оба полученных файла были PNG размером 2048 × 2048 при настройке 2k.
Тёплый свет лампы меняет сцену
Парное изображение показывает розу и деревянную полку под тёплой настольной лампой. Оно получено из того же запроса, что и кадр с бледным утренним светом, с двумя результатами и квадратным холстом. Сравните пару, чтобы увидеть заданную смену освещения вместе с сохранёнными объектом и полкой.
Определите роль каждого кадра
Запишите общие требования один раз, затем опишите изображения по порядку. Запрос допускает от двух до десяти результатов, до десяти общих референсов и разрешение 2k, 4k или 8k. Количество, форма и разрешение выбираются отдельно; согласуйте каждое решение с серией, которую планируете оценивать.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательный параметр, до 21 000 символов. Задайте правила для всей серии, затем опишите каждое изображение по порядку. Не менее 1 символов · Не более 21000 символов |
reference_image_urls | Нет | Необязательно, до 10 изображений для всей серии. Файлы должны быть в формате JPG или PNG, не более 30 МБ, от 300 px по стороне, с соотношением от 2:5 до 5:2. Не более 10 элементов |
num_outputs | Нет | Количество изображений в серии, от 2 до 10. По умолчанию 4; оплачивается каждое полученное изображение. |
resolution | Нет | Уровень серии: 2k, 4k или 8k. По умолчанию 2k; старшие уровни повышают цену каждого изображения. |
aspect_ratio | Нет | Форма всей серии: auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 или 21:9. По умолчанию auto; выбор не влияет на цену. |
Стоимость
Каждое изображение серии оплачивается по тарифу выбранного разрешения, а каждый референс добавляет небольшую плату за ввод.
| Спецификация | Стоимость |
|---|---|
| $0.063 / изображение |
| $0.094 / изображение |
| $0.157 / изображение |
Сценарии использования
Изучение освещения продукта
Сравните продукт при разном освещении, попросив сохранить объект и его положение. Наш запрос с розой вернул утренний вид и вечерний вид при свете лампы одной и той же сцены на полке.
Планы ремесленного процесса
Опишите работу в мастерской пронумерованными этапами и согласуйте num_outputs с задуманной последовательностью. Назовите инструменты, материалы и детали рабочего места, которые нужно сохранить во всех кадрах.
Планирование ракурсов для каталога
Задайте каждому изображению свой ракурс продукта, добавив общий референс и список сохраняемых деталей. Сверьте полученные объекты с референсом перед выбором материалов для каталога.
Изучение композиций для кампании
Используйте общие объект и палитру, задавая каждому изображению отдельную композицию. Выберите поддерживаемое соотношение сторон для места размещения и проверьте визуальную связность группы.
Руководство по промптам и практические советы
Определите общий объект
Опишите продукт, место или персонажа в профессиональном контексте, который связывает серию. Укажите детали, которые нужно сохранить, прежде чем перечислять отдельные изображения.
Задайте назначение каждому изображению
Пронумеруйте изображения в нужном порядке и опишите один ракурс или момент для каждого. Установите
num_outputsравным этому количеству, от двух до десяти.Сопоставьте референсы и настройте холст
Если нужна визуальная опора, добавьте общие референсы и укажите их как @
image_1и @image_2. Выберите разрешение и соотношение сторон серии.Оцените последовательность целиком
Сравните детали объекта и композицию всех полученных изображений. Пример с розой позволяет изучить освещение на паре изображений перед составлением собственного задания.
Постройте последовательность вокруг общего объекта
Эндпоинт Kling Image 4.0 Set принимает задание на два–десять связанных изображений. Опишите серию целиком, затем задайте каждому изображению место и визуальное назначение. Необязательные референсы действуют во всём запросе, поэтому фотография продукта может стать опорой для изучения освещения или набора ракурсов.
При планировании важно определить связность: решите, какие детали должны остаться узнаваемыми, а какие — измениться. Для изучения света назовите объект и его положение постоянными деталями, затем задайте каждому изображению свой источник освещения. Для последовательности процесса один раз определите рабочее место и опишите задачу на каждом этапе.
Параметры запроса
Ниже приведены публичные поля этого эндпоинта. Согласуйте запрошенное количество изображений с пронумерованными описаниями в промпте.
| Поле | Обязательное | Варианты и ограничения | Назначение |
|---|---|---|---|
prompt | Да | 1–21,000 символов | Опишите серию, изображения по порядку и сохраняемые детали. Указывайте референсы как @image_1, @image_2. |
reference_image_urls | Нет | До 10 файлов JPG или PNG | Общие визуальные референсы. Каждый файл может занимать до 30 MB, должен иметь не менее 300 px по каждой стороне и соотношение сторон от 2:5 до 5:2. |
num_outputs | Нет | 2–10; по умолчанию 4 | Количество запрошенных связанных изображений. |
resolution | Нет | 2k, 4k, 8k; по умолчанию 2k | Уровень разрешения, определяющий тариф изображения. |
aspect_ratio | Нет | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9; по умолчанию auto | Форма серии; auto выбирает её по промпту и референсам. |
Считайте изображения и референсы отдельно
Референс даёт визуальные входные данные, но не задаёт число изображений серии. В запросе с розой использовался один референс, а num_outputs был равен двум. Выбирайте количество осознанно, не предполагая, что его определяет число загруженных файлов.
Рассчитайте бюджет полученной серии
Используйте указанную на этой странице цену выбранного разрешения. Каждое полученное изображение оплачивается по этому тарифу, а каждый референс добавляет небольшую плату за ввод. Поэтому серия оплачивается за полученные изображения и входные референсы, а не как одна картинка. Перед отправкой запроса совместно проверьте количество результатов, разрешение и число референсов.
Напишите задание с постоянными деталями и запланированными изменениями
Начните с общих объекта, окружения и визуального оформления. Затем добавьте пронумерованные описания изображений и понятное указание о сохранении деталей. Используйте место в промпте для того, что проверяющий сможет оценить: пропорций продукта, расположения на полке, ракурса камеры и освещения.
Задайте каждому изображению одну визуальную задачу
В продуктовой серии один кадр может представлять объект, а другой — показывать его при ином свете. В процессе работы мастерской каждое изображение может отражать названный этап. Опишите различия между кадрами, чтобы у запроса была полезная последовательность.
Назначьте референсам конкретную роль
Укажите продукт в @image_1 или окружение в @image_2, затем объясните, что серия должна сохранить из каждого источника. Убедитесь, что номера совпадают с порядком входных данных.
Осознанно выбирайте форму и разрешение
У серии общие настройка соотношения сторон и уровень разрешения. Если нужен квадратный макет, выберите 1:1, а не оставляйте форму на усмотрение auto. В запуске с розой использовались 1:1 и 2k. Оцените композицию и сохранённые детали объекта, прежде чем решать, подходит ли вашей работе другой уровень.
Что вернул запрос с розой
18 ноября 2026 года мы отправили промпт с просьбой показать продукт из референса на деревянной полке в двух условиях освещения. Настройки включали один референс, два результата, разрешение 2k и соотношение сторон 1:1. Запрос вернул два PNG размером 2048 × 2048.
Утро и вечер по одному заданию
Утренний кадр показывает розу на деревянной полке в бледном свете. Парное изображение показывает ту же розу на той же полке под тёплой настольной лампой. Оба вида получены из одного запроса. Рассматривайте их вместе, оценивая сохранение деталей и заданное изменение освещения.
Проверьте группу перед выбором изображений
Разместите полученные изображения рядом и сравните с общими требованиями промпта. В исследовании продукта проверьте пропорции и положение объекта, а также запланированные изменения света. В плане процесса убедитесь, что присутствует каждый запрошенный этап и что детали рабочего места связывают последовательность. Если какой-либо вид нужно исправить, уточните его описание, сохранив ясность общих инструкций.
Ограничения и связанные варианты
Количество изображений должно оставаться в пределах от двух до десяти, а промпт — укладываться в 21,000 символов. Сверьте каждый референс с требованиями к файлам, размерам и соотношению сторон в таблице. Генерация серии по-прежнему требует визуальной проверки: сравните детали продукта и задуманные изменения во всех полученных кадрах до использования в каталоге или кампании.
Для задания на отдельное изображение сравните Kling Image 4.0. Для непрерывной композиции страницы рассмотрите Kling Image 4.0 Long: по словам Kling, режим длинного изображения создаёт одно полное изображение страницы. Выбирайте в зависимости от того, нужны ли вам отдельные изображения или непрерывный макет страницы.
Быстрый старт 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-set/text-to-image",
"input": {
"aspect_ratio": "auto",
"num_outputs": 4,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.













