Введение
Загрузите от одного до десяти изображений, сошлитесь на них по номерам в инструкции и опишите изменение. Так можно сменить стиль фото, перенести объект в другое место или объединить людей, одежду и товары.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Издатель | Kling |
| Дата выпуска | 17 ноября 2026 года |
| Задачи | Генерация по тексту; редактирование изображений |
| Длина промпта | От 1 до 21 000 символов |
| Уровни разрешения | 2k (по умолчанию), 4k, 8k |
| Независимые результаты | От 1 до 9 за запрос; по умолчанию 1 |
| Соотношения сторон результата | auto (по умолчанию), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 |
| Референсы для редактирования | От 1 до 10 изображений с указанием по порядку загрузки |
| Форматы референсов | JPG или PNG |
| Размер файла референса | До 30 MB на изображение |
| Размеры референсов | Не менее 300 px по каждой стороне; соотношение от 2:5 до 5:2 |
| Основа расчёта | За каждое переданное изображение по разрешению; при редактировании также за каждый референс |
Ключевые возможности и особенности
Верный заголовок и лишние строки
SLOW STEEP разместил заданный заголовок над гравированным чайником цвета индиго на кремовой бумаге. При этом появились придуманные вспомогательные строки. Результат в 2k показывает, почему в задании плаката нужно определить требуемые слова и границы дополнительных надписей.
Лодки и рассветный туман в 4k
Промпт гавани перечислял деревянные рыбацкие лодки, туман и бледный золотистый свет. Результат объединил их в широкую рассветную сцену и вернулся как PNG 5440 x 3072 на уровне 4k. Рассмотрите лодки и мягкий свет при планировании редакционного изображения.
Иллюстрация папоротника на 8192 пикселя
Ботанический запуск вернул PNG 8192 x 8192 с тонкими линиями туши и приглушённой зелёной акварелью на бумаге молочного оттенка. Пример показывает квадратную композицию и сочетание нарисованных контуров с акварелью.
Роза, перерисованная на янтарном фоне
Редактирование сохранило узнаваемую розу, изменив оформление на рисованную вручную винтажную рекламу. Без запроса появились ROSE и NATURAL ESSENCE. Проверяйте добавленные слова так же внимательно, как сохранение объекта.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательный параметр, до 21 000 символов. Ссылайтесь на файлы как @ |
image_urls | Да | От одного до десяти референсов, пронумерованных в порядке загрузки. Подходят файлы JPG или PNG до 30 МБ, не менее 300 px по стороне, с соотношением от 2:5 до 5:2. Не менее 1 элементов · Не более 10 элементов |
num_outputs | Нет | Количество независимых результатов, от 1 до 9. По умолчанию 1; оплачивается каждое полученное изображение. |
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 / изображение |
Сценарии использования
Плакаты чайного фестиваля
Укажите название события в кавычках, цвет бумаги и центральную иллюстрацию. Плакат SLOW STEEP в 2k верно воспроизвёл заголовок над чайником цвета индиго, но добавил вспомогательные строки, требующие проверки перед передачей макета.
Гавани для редакционных макетов
Опишите место через видимые предметы и свет, затем выберите широкий кадр для нужного размещения. Наш запуск в 4k вернул PNG 5440 x 3072 с деревянными рыбацкими лодками, туманом и бледным рассветным светом.
Ботаническая графика для крупных макетов
Задайте растение, бумагу, линии и цветовое решение до выбора разрешения. Квадратная иллюстрация папоротника в 8k вернулась как PNG 8192 x 8192 с тушью и приглушённой зелёной акварелью на бумаге молочного оттенка.
Рекламные концепции по референсу
Передайте изображение товара в редактирование и опишите новое оформление. Роза осталась узнаваемой на янтарном фоне, но добавленные ROSE и NATURAL ESSENCE потребовали проверки.
Руководство по промптам и практические советы
Выберите исходный материал
Используйте генерацию по тексту для описанной сцены, а редактирование — когда существующее изображение задаёт объект или визуальное направление.
Опишите сцену или изменение
Укажите объект, обстановку, свет и точный текст надписей. Для редактирования назначьте источники по порядку загрузки как @
image_1и @image_2, затем поясните, что изменить и что сохранить.Задайте кадр и количество
Выберите 2k, 4k или 8k и поддерживаемое соотношение сторон либо оставьте auto. Запросите от одного до девяти независимых изображений и проверьте цену для выбранного разрешения и референсов.
Проверьте надписи вместе с деталями
Сопоставьте текст с вашим оригиналом, а изменённые объекты — с референсами. Наш чайный плакат и реклама розы получили незапрошенные слова. Для строгого макета добавьте «без других слов» и вычитайте результат.
Измените изображение по определённому заданию
Передайте существующие картинки, если исходный объект или оформление важны для следующего дизайна. Редактирование Kling Image 4.0 принимает промпт и от одного до десяти референсов. Задание объясняет роль каждого, нужное изменение и детали, которые должны остаться узнаваемыми.
Наша роза превратилась в рисованную вручную винтажную рекламу на янтарном фоне. Роза сохранила узнаваемость, но появились нежелательные надписи. Проверьте объект и дизайн целиком перед выбором результата для передачи.
Подготовьте референсы и настройки
Проверьте форматы и порядок загрузки перед нумерацией ссылок. Сопоставьте каждый источник с его ролью, чтобы номера и инструкции совпадали.
Таблица параметров
Промпт и референсы обязательны. Количество, разрешение и соотношение сторон необязательны и имеют следующие значения.
| Параметр | Допустимый ввод | По умолчанию | Применение |
|---|---|---|---|
prompt | Обязательная строка, от 1 до 21 000 символов | Нет | Указать референсы, отделить изменения от сохранения. |
image_urls | Обязательный массив из 1–10 изображений | Нет | Передать JPG или PNG в указанном порядке. |
num_outputs | Целое число от 1 до 9 | 1 | Запросить независимые результаты редактирования. |
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 | Зафиксировать форму или следовать промпту и референсам. |
Каждый референс может занимать до 30 MB, должен иметь не менее 300 px по каждой стороне и соотношение от 2:5 до 5:2. Это требования к входным изображениям. Выбирайте выходной кадр отдельно, не предполагая, что его определяют размеры источника.
Распределите роли в задании
Объясните вклад каждой картинки до описания отделки. Например, запросите керамический предмет из @image_1 и палитру из @image_2. Затем задайте фон и оформление, разделив сохраняемые детали и изменения.
Сопоставьте ссылки с порядком входа
@image_1 обозначает начало массива референсов, @image_2 — следующий элемент. У каждой ссылки должна быть роль: объект, палитра или оформление. Если изменение противоречит исходной детали, уточните, какую часть нужно изменить.
Опишите сохранение конкретно
Назовите важные видимые признаки: форму ручки кувшина, контур цветка или отметины товара. Затем укажите изменение — рисованную поверхность, другой цвет фона или новое расположение. Сравните результат с оригиналом; указание о сохранении не заменяет проверку.
Контролируйте текст даже при смене стиля
«Винтажная реклама» описывает жанр, но оставляет место придуманным словам. Укажите точный текст или попросите обойтись без надписей. Добавьте «без других слов» для строгой границы и проверьте результат. Роза показывает, почему надписи важны даже при визуальной смене стиля.
Наблюдаемый результат: роза на янтарном фоне
amber-rose-vintage-ad использовал референс, уровень 2k, соотношение 2:3 и один результат. Вернулся PNG 1664 x 2496. Роза сохранила узнаваемость и была перерисована на янтарном фоне согласно направлению ручной росписи.
Слова, появившиеся без запроса
Та же выдача включала ROSE и NATURAL ESSENCE. Ни одного выражения не было в задании. Считайте это дефектом для проверки перед передачей рекламы, даже если объект сохранён. Сопоставьте каждое слово с исходным текстом, включая мелкие строки вокруг главного объекта.
Разберитесь с оплатой перед добавлением источников
Смотрите отображаемую цену выбранного разрешения. Каждое переданное изображение оплачивается по этому уровню, а каждый референс добавляет небольшую входную плату. Подбирайте источники под изменение, чтобы оценить назначение и стоимость каждого. Рост числа независимых результатов увеличивает и объём проверки.
Выберите процесс под результат
Используйте генерацию по тексту, если исходная картинка не нужна. Редактирование подходит, когда входное изображение задаёт объект или направление. Для правки назовите нужную деталь и изменение вместе с сохраняемыми признаками. Сравните каждый новый результат с источниками перед выбором.
По данным Kling, серийный процесс планирует связанные изображения, а длинный создаёт целостный визуал карточки товара или веб-страницы. Выберите Kling Image 4.0 Set (kling/image-4.0-set) для коллекции или Kling Image 4.0 Long (kling/image-4.0-long) для длинной страницы. От одного до девяти независимых правок не образуют согласованную серию. При сравнении с другой моделью используйте те же источники и задание, затем вместе оцените сохранение объекта, изменения фона и добавленный текст.
Быстрый старт 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/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"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.















