
Kling Image 4.0 API открывает разработчикам доступ к новейшей модели изображений Kling AI через один эндпоинт PoYo: вызывайте kling-4.0-image для text-to-image, редактирования и серий изображений в 2K, 4K или 8K, а kling-4.0-long-image для полноценного дизайна веб-страниц или страниц интернет-магазина. В этой статье разбираем, что такое Kling Image 4.0, за что отвечает каждое поле запроса, какие действуют лимиты и сколько стоит вызов в PoYo.
Что такое Kling Image 4.0?
Kling Image 4.0 — модель изображений из семейства Kling 4.0 от Kling AI, креативной AI-платформы компании Kuaishou. Она вышла 17 ноября 2026 года. В анонсе Kling сообщает, что модель:
- генерирует изображения в нативном 8K, которое Kling впервые представляет именно в этой модели;
- создаёт до 10 изображений по одному промпту с единым стилем и содержанием;
- отрисовывает до 2,000 символов текста на одном изображении на английском, упрощённом китайском, традиционном китайском, японском, корейском, испанском и португальском;
- создаёт длинные изображения для карточек товаров в e-commerce и веб-дизайна.
Kling также сообщает, что модель доступна в Kling Creative Studio и через API для компаний и разработчиков. PoYo добавил Kling Image 4.0 API в ноябре 2026 года — без листа ожидания и с тем же API-ключом, который вы используете для всех остальных моделей PoYo.
ID моделей Kling Image 4.0 API в PoYo
| ID модели | Для чего | Результат |
|---|---|---|
kling-4.0-image | Text-to-image (без image_urls), image-to-image с 1–10 референсами, элементы, серии изображений | 1–9 независимых изображений или серия из 2–10, в 2K / 4K / 8K |
kling-4.0-long-image | Дизайн страниц skill: "webpage", карточки товаров skill: "ecommerce" по 1–3 фото товара | Одно высокое изображение шириной 1024 px (1K) или 2048 px (2K) |
Оба ID используют один и тот же эндпоинт отправки, один и тот же опрос статуса и один и тот же вебхук callback_url. Слаг страницы модели — kling-4-0-image; ID моделей в запросе пишутся через точки (kling-4.0-image).
Эндпоинт и структура запроса
Каждый запрос к Kling Image 4.0 API — это асинхронная задача:
POST https://api.poyo.ai/api/generate/submitсAuthorization: Bearer $POYO_API_KEYи JSON-телом изmodelиinput.- Прочитайте
data.task_idиз ответа. - Опрашивайте
GET https://api.poyo.ai/api/generate/status/{task_id}, покаstatusне станетfinishedилиfailed, либо передайтеcallback_urlна верхнем уровне и получите POST по завершении задачи.
Минимальный запрос в 4K по структуре из документации:
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
Завершённая задача возвращает изображения в data.files, каждое с file_url и file_type: "image". Серии изображений возвращаются по порядку. Проверяйте не только HTTP-статус, но и поле code в теле ответа: при ошибке валидации PoYo может вернуть HTTP 200 с code: 400. Пошаговая версия с cURL и Python — в руководстве по Kling Image 4.0 API.
Входные поля и лимиты
kling-4.0-image
| Поле | Значения | Примечания |
|---|---|---|
prompt | 1–50,000 символов | Обязательно. Ссылайтесь на входы как @Image1, @Element1 |
image_urls | 1–10 URL | Включает image-to-image. Каждое изображение до 30 MB, не меньше 300 px по каждой стороне, соотношение сторон 0.4–2.5 |
kling_elements | до 7 элементов | Каждый {"element_input_urls": [...]} с 2–4 ракурсами, фронтальный первым. Требует image_urls. Изображения плюс элементы ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | По умолчанию auto |
resolution | 2K, 4K, 8K | По умолчанию 2K. 8K — это 8192×8192 при 1:1 |
enable_sequential | true / false | true возвращает согласованную серию изображений |
n | 1–9 (независимые) или 2–10 (серия) | По умолчанию 1 и 4 |
Схема отклоняет неизвестные поля, поэтому не передавайте output_format, seed и negative_prompt. Результат — PNG.
kling-4.0-long-image
| Поле | Значения | Примечания |
|---|---|---|
skill | webpage (по умолчанию), ecommerce | Выбирает тип страницы |
image_urls | 1–3 фото товара | Обязательно для ecommerce |
style_image_url / subject_image_url | по одному URL | Только webpage; @StyleImage, @SubjectImage |
length | short, medium (по умолчанию), long | Только ecommerce: примерно 2–5, 6–10 или 11–18 секций |
resolution | 1K (по умолчанию), 2K | Ширина 1024 или 2048 px; высота зависит от содержимого |
Каждый запрос long-image возвращает одно изображение.
Цены Kling Image 4.0 API в PoYo
PoYo тарифицирует каждое сгенерированное изображение (1 кредит = $0.005). Кредиты списываются только при успешном выполнении задачи.
| Запрос | Кредиты | USD |
|---|---|---|
kling-4.0-image, 2K, за изображение | 13 | $0.065 |
kling-4.0-image, 4K, за изображение | 19 | $0.095 |
kling-4.0-image, 8K, за изображение | 32 | $0.16 |
Каждый элемент image_urls и каждый элемент kling_elements, один раз за запрос | 1 | $0.005 |
| Длинное изображение, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Длинное изображение, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Длинное изображение, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Длинное изображение, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Длинное изображение, каждое изображение в image_urls, style_image_url или subject_image_url | 1 | $0.005 |
В разборе цен есть таблицы для длинных изображений и примеры расчётов.
Что мы измерили в день запуска
Команда PoYo выполнила эти запросы на продакшен-API 19 ноября 2026 года. Время указано от отправки до результата с точки зрения клиента, опрашивающего статус, поэтому считайте его приблизительным.
| Запрос | Результат | Стоимость | Время |
|---|---|---|---|
kling-4.0-image, text-to-image, 16:9, 8K, n: 1 | PNG 10880×6144, около 128 MB | 32 кредита | около 3.8 мин |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | четыре изображения 2720×1536, тот же мотоциклист, мотоцикл и одежда от рассвета до ночи | 52 кредита | около 4.9 мин |
kling-4.0-long-image, skill: "webpage", 1K | одна страница 1024×4257 | 110 кредитов | около 1.7–2.2 мин |
Два замечания по интеграции из того же прогона. Скачанные файлы были PNG с альфа-каналом (RGBA) даже для непрозрачных изображений, поэтому явно конвертируйте их, если ваш пайплайн ожидает RGB или JPEG. А длинный промпт веб-страницы на английском, в котором не был указан язык текста страницы, вернул страницу с китайским текстом; добавление "All text on the page is in English." решило проблему. Подробнее об обоих моментах — в статье 8K и длинные изображения.
Какие запросы стоит отправлять в Kling Image 4.0 API?
- Печать, билборды и работа с активным кадрированием, где нужно больше 4K: это единственная модель изображений в PoYo с уровнем
8K. - Раскадровки, ракурсы товара и слайды, где один персонаж или товар должен оставаться одинаковым во всех кадрах: используйте
enable_sequential. - Размещение известного товара или персонажа в новой сцене: передайте сцену в
image_urls, а объект — как элемент с несколькими ракурсами. - Макеты лендингов и карточки товаров для e-commerce одним изображением:
kling-4.0-long-image.
Для быстрых черновиков в 1K–2K по минимальной цене Kling O3 Image дешевле за изображение; см. Kling Image 4.0 API vs Kling O3 Image. Чтобы сравнить с моделями других вендоров, читайте Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Часто задаваемые вопросы
Что такое Kling Image 4.0 API?
Это REST-доступ PoYo к модели Kling Image 4.0 от Kling AI под ID моделей kling-4.0-image (обычные изображения, редактирование и серии изображений) и kling-4.0-long-image (длинные веб-страницы и страницы e-commerce). Обе используют POST /api/generate/submit и один и тот же API-ключ.
Сколько стоит Kling Image 4.0 API? 13 кредитов ($0.065) за изображение в 2K, 19 кредитов ($0.095) в 4K и 32 кредита ($0.16) в 8K, плюс 1 кредит ($0.005) за каждое референсное изображение или элемент один раз за запрос. Длинные изображения стоят от 47 до 173 кредитов за страницу. Неудачные задачи не тарифицируются.
Поддерживает ли Kling Image 4.0 API image-to-image?
Да. Передайте от 1 до 10 URL в image_urls вместе с kling-4.0-image и ссылайтесь на них в промпте как @Image1, @Image2. Добавьте до 7 kling_elements для единообразных персонажей или объектов; изображения плюс элементы ограничены 10.
Сколько выполняется запрос к Kling Image 4.0 API?
В нашем тесте в день запуска одно изображение 16:9 в 8K заняло около 3.8 минуты, серия из четырёх изображений 2K — около 4.9 минуты, а веб-страница в 1K — около 2 минут. Для больших задач используйте callback_url, а не держите запрос открытым.
Где документация Kling Image 4.0 API? Описание полей — в документации Kling Image 4.0 и документации по длинным изображениям. На странице модели есть playground, который показывает JSON для ваших настроек.