Введение
Опишите сцену, постер или персонажа и получите готовые изображения. В каждом запросе можно выбрать разрешение, формат и количество независимых вариантов.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Издатель | 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 символов. Укажите объект, действие, место, камеру и свет, а слова для отображения заключите в кавычки. Не менее 1 символов · Не более 21000 символов |
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 требует промпт и предлагает 2k, 4k и 8k с одним-девятью независимыми изображениями за запрос. Наши запуски включают плакат чайного фестиваля, гавань на рассвете и папоротник тушью и акварелью.
Пакет даёт независимые варианты одного задания. Выбирайте количество, которое удобно проверить; для согласованной коллекции используйте связанную семью Set.
Управление запросом
Промпт обязателен. Остальные настройки задают количество, разрешение и форму; при их отсутствии действуют значения ниже.
| Параметр | Допустимый ввод | По умолчанию | Практическая роль |
|---|---|---|---|
prompt | Обязательная строка, от 1 до 21 000 символов | Нет | Описать объект, окружение, свет и точные слова. |
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 | Задать кадр или доверить модели трактовку задания. |
Выбирайте разрешение под требования передачи, а соотношение сторон под размещение. Проверяйте реальные размеры файла при подготовке макета; примеры ниже показывают размеры наших результатов.
Задайте композицию для рисунка
Начните с видимого объекта и его окружения, затем уточните свет и оформление. Промпт гавани называет деревянные лодки, рассветный туман и бледный золотистый свет. Промпт папоротника — растение, бумагу молочного оттенка, тонкие линии туши и приглушённую зелёную акварель. Это описание видимых элементов вместо общих похвал качеству.
Отделите указания о надписях
Для плаката заключите заголовок в кавычки и укажите его положение. Отделите обязательные слова от иллюстрации, добавив «без других слов», если лишний текст мешает. Вычитайте всё изображение, включая мелкие незапрошенные строки.
По данным Kling, изображение может содержать до 2 000 символов сгенерированного текста. Это не лимит промпта в 21 000 символов: один относится к нарисованным надписям, другой — ко всему описанию. Группируйте заголовки и вспомогательные строки по расположению, чтобы указания по макету оставались понятными.
Согласуйте сцену с кадром
При известном размещении выбирайте фиксированные пропорции: вертикальный плакат и широкая редакционная сцена требуют разных кадров. auto позволяет промпту направлять форму. После смены разрешения проверьте новое изображение, не предполагая, что прежние композиция и надписи перенеслись без изменений.
Результаты запусков 18 ноября
Три запуска по тексту использовали разные объекты, разрешения и формы кадра. Рассмотрите композицию, фактуры и надписи при планировании своего изображения.
Чайный плакат в 2k
SLOW STEEP использовал 3:4 и вернул один PNG 1760 x 2336. Заголовок был верным над гравированным чайником индиго на кремовой бумаге. Модель также придумала вспомогательные строки. Проверьте их вместе с заголовком перед использованием.
Гавань в 4k
Рассветная гавань в 16:9 вернула один PNG 5440 x 3072 с деревянными лодками, туманом и бледным светом. Широкий кадр оставляет место лодкам, туману и окружающей гавани.
Папоротник в 8k
Квадратное ботаническое задание вернуло один PNG 8192 x 8192 с папоротником тушью и акварелью на бумаге молочного оттенка. Kling называет 8k нативной генерацией. Проверьте тонкость линий, цветовое решение и квадратный кадр в примере.
Решения о цене и проверке
Смотрите цену выбранного разрешения на странице. Каждое переданное изображение оплачивается по этому уровню; больше независимых результатов означает больше изображений для оплаты и проверки. Соотношение сторон цену не меняет. Оцените макет на выбранном уровне, прежде чем заказывать другое разрешение или пакет.
Область применения и связанные семейства
Эндпоинт принимает текст вместо исходного изображения. Используйте редактирование на этой странице, если существующий объект или фотография должны направлять результат.
По описанию 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "auto"
}
}'
# 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.















