guides

Kling Image 4.0 API: что такое Kling Image 4.0, ID моделей и цены

Poyo.ai Team
8 min read
Share:

Kling Image 4.0 API в PoYo: нативные изображения 8K, серии изображений и дизайн длинных страниц

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-imageText-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 — это асинхронная задача:

  1. POST https://api.poyo.ai/api/generate/submit с Authorization: Bearer $POYO_API_KEY и JSON-телом из model и input.
  2. Прочитайте data.task_id из ответа.
  3. Опрашивайте 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

ПолеЗначенияПримечания
prompt1–50,000 символовОбязательно. Ссылайтесь на входы как @Image1, @Element1
image_urls1–10 URLВключает image-to-image. Каждое изображение до 30 MB, не меньше 300 px по каждой стороне, соотношение сторон 0.4–2.5
kling_elementsдо 7 элементовКаждый {"element_input_urls": [...]} с 2–4 ракурсами, фронтальный первым. Требует image_urls. Изображения плюс элементы ≤ 10
sizeauto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9По умолчанию auto
resolution2K, 4K, 8KПо умолчанию 2K. 8K — это 8192×8192 при 1:1
enable_sequentialtrue / falsetrue возвращает согласованную серию изображений
n1–9 (независимые) или 2–10 (серия)По умолчанию 1 и 4

Схема отклоняет неизвестные поля, поэтому не передавайте output_format, seed и negative_prompt. Результат — PNG.

kling-4.0-long-image

ПолеЗначенияПримечания
skillwebpage (по умолчанию), ecommerceВыбирает тип страницы
image_urls1–3 фото товараОбязательно для ecommerce
style_image_url / subject_image_urlпо одному URLТолько webpage; @StyleImage, @SubjectImage
lengthshort, medium (по умолчанию), longТолько ecommerce: примерно 2–5, 6–10 или 11–18 секций
resolution1K (по умолчанию), 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 / 2K110 / 120$0.55 / $0.60
Длинное изображение, ecommerce short, 1K / 2K47 / 57$0.235 / $0.285
Длинное изображение, ecommerce medium, 1K / 2K94 / 110$0.47 / $0.55
Длинное изображение, ecommerce long, 1K / 2K157 / 173$0.785 / $0.865
Длинное изображение, каждое изображение в image_urls, style_image_url или subject_image_url1$0.005

В разборе цен есть таблицы для длинных изображений и примеры расчётов.

Что мы измерили в день запуска

Команда PoYo выполнила эти запросы на продакшен-API 19 ноября 2026 года. Время указано от отправки до результата с точки зрения клиента, опрашивающего статус, поэтому считайте его приблизительным.

ЗапросРезультатСтоимостьВремя
kling-4.0-image, text-to-image, 16:9, 8K, n: 1PNG 10880×6144, около 128 MB32 кредитаоколо 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×4257110 кредитовоколо 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 для ваших настроек.

Share: