
Kling Image 4.0 API (kling-4.0-image) — преемник Kling O3 Image API (kling-o3-image и kling-o3-image-edit) в PoYo. Коротко: Kling Image 4.0 добавляет 8K, серии изображений, промпт до 50,000 символов и отдельную модель для длинных страниц, а за изображение стоит примерно в три-четыре раза дороже. В этой статье мы сравниваем их запрос за запросом, чтобы вы могли решить, какие вызовы переносить. Обе модели доступны в PoYo: Kling Image 4.0 и Kling O3 Image.
Решение в одной таблице
| Если вашему запросу нужно… | Вызывайте |
|---|---|
| Вывод 1K или минимальная цена за изображение | kling-o3-image / kling-o3-image-edit |
| JPEG или WebP прямо из API | Kling O3 Image (output_format) |
| Больше 4K или ровно 8K | kling-4.0-image |
| Серия из 2–10 изображений с тем же объектом и стилем | kling-4.0-image с enable_sequential |
| Промпты длиннее 2,000 символов | kling-4.0-image (до 50,000) |
| Целая веб-страница или карточка товара e-commerce одним изображением | kling-4.0-long-image |
| Text-to-image и редактирование под одним ID модели | kling-4.0-image |
Различия запросов поле за полем
Обе модели используют POST https://api.poyo.ai/api/generate/submit, один и тот же эндпоинт статуса и один и тот же callback_url. Различия — в model и input, по документации PoYo для каждой модели.
| Поле | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
model | kling-o3-image (text-to-image), kling-o3-image-edit (редактирование) | kling-4.0-image для обоих; image_urls включает режим редактирования |
prompt | до 2,000 символов | 1–50,000 символов |
image_urls | 1–10, обязательно для kling-o3-image-edit | 1–10 (необязательно); каждое 30 MB, ≥300 px, соотношение 0.4–2.5 |
| Элементы | elements: [{frontal_image_url, reference_image_urls}] | kling_elements: [{element_input_urls: [front, …]}], 2–4 ракурса, до 7, изображения + элементы ≤ 10 |
resolution | 1K (по умолчанию), 2K, 4K | 2K (по умолчанию), 4K, 8K |
size | 8 соотношений, по умолчанию 16:9; auto только в модели редактирования | те же 8 соотношений плюс auto, по умолчанию auto |
output_format | jpeg, png (по умолчанию), webp | не принимается; только PNG |
n | 1–9 | 1–9 независимых или 2–10 с enable_sequential: true |
enable_sequential | недоступно | true возвращает упорядоченную согласованную серию |
| Длинные страницы | недоступно | отдельная модель kling-4.0-long-image |
В анонсе Kling описывает Kling Image 4.0 как свою первую модель с нативной генерацией 8K, способную спланировать до 10 изображений по одному промпту и отрисовать до 2,000 символов текста на семи языках. Это заявления Kling; различия в API выше — это то, что меняется в вашем коде.
Цена одного и того же запроса
Цены PoYo, 1 кредит = $0.005. У Kling O3 Image в PoYo нет доплаты за референсы; Kling Image 4.0 API добавляет 1 кредит за каждое референсное изображение или элемент один раз за запрос. На странице цен Kling отмечено то же изменение: Kling Image 4.0 тарифицирует референсные входы, более ранние модели — нет.
| Один и тот же запрос | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
| 1 изображение, 1K | 3.5 кредита ($0.0175) | недоступно (минимум 2K: 13 кредитов) |
| 1 изображение, 2K | 3.5 кредита ($0.0175) | 13 кредитов ($0.065) |
| 1 изображение, 4K | 7 кредитов ($0.035) | 19 кредитов ($0.095) |
| 1 изображение, 8K | недоступно | 32 кредита ($0.16) |
| Правка 2K, 2 референсных изображения + 1 элемент | 3.5 кредита ($0.0175) | 16 кредитов ($0.08) |
| 4 изображения в 2K | 14 кредитов ($0.07), независимые | 52 кредита ($0.26), серией или независимо |
| Дизайн веб-страницы, 1K | недоступно | 110 кредитов ($0.55) |
В 2K Kling Image 4.0 API стоит примерно в 3.7× дороже Kling O3 Image за изображение, а в 4K — примерно в 2.7×. Полные таблицы Kling Image 4.0 — в статье цены Kling Image 4.0 API.
Какие лимиты меняются
- Минимальное разрешение растёт. 1K больше нет; минимальный вывод Kling Image 4.0 — 2K. Если вы отдаёте миниатюры, оставьте их на O3 или уменьшайте на своей стороне.
- Потолок поднимается до 8K. Документация PoYo указывает 8192×8192 при 1:1. В нашем тесте в день запуска (продакшен-API PoYo, 19 ноября 2026 года) запрос 16:9 в 8K вернул PNG 10880×6144 размером около 128 MB примерно за 3.8 минуты, стоимость — 32 кредита.
- Работа с файлами. Нет
output_format: вы получаете PNG. Наши скачанные файлы были PNG в RGBA даже для непрозрачных изображений. Запланируйте конвертацию и хранение, если на O3 вы использовалиjpegилиwebp. - Правила для референсов явные. Kling Image 4.0 валидирует каждый референс: до 30 MB, не меньше 300 px по каждой стороне, соотношение ширины к высоте от 0.4 до 2.5. В документации O3 таких лимитов нет, поэтому перед миграцией проверьте очень широкие или маленькие изображения.
- Серии выполняются дольше. Наша серия из четырёх изображений 2K заняла около 4.9 минуты. Переводите долгие или большие задачи на
callback_url.
Когда переходить
Переводите вызов на kling-4.0-image, когда ему нужно то, чего O3 не умеет: 8K, согласованная серия, длинный промпт или дизайн страницы. Например:
- Раскадровки и ракурсы товара. На O3 вы отправляете
n: 4и надеетесь, что объект совпадёт. Сenable_sequential: trueмодель планирует серию; в нашем тесте сохранились тот же мотоциклист, мотоцикл и одежда на рассвете, в полдень, на закате и ночью. - Печать и материалы с активным кадрированием. Всё, что выше 4K.
- Длинные структурированные промпты. Брендбуки, списки кадров и блоки текста длиннее 2,000 символов.
- Страницы e-commerce.
kling-4.0-long-imageстроит всю карточку товара; у O3 аналога нет.
Оставьте O3 для больших объёмов черновиков 1K–2K, миниатюр и пайплайнов, которым нужен JPEG или WebP из API. Использовать обе модели — нормально: O3 для поиска, Kling Image 4.0 для финальной серии, на одном и том же ключе.
Diff для миграции
Вызов text-to-image:
{
- "model": "kling-o3-image",
+ "model": "kling-4.0-image",
"input": {
"prompt": "A cinematic futuristic alley with rain and neon reflections",
"resolution": "4K",
"size": "16:9",
- "output_format": "png",
"n": 2
}
}
Правка с элементом. Два переименования полей и слияние ID моделей:
{
- "model": "kling-o3-image-edit",
+ "model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
- "elements": [
- {
- "frontal_image_url": "https://example.com/character-front.png",
- "reference_image_urls": ["https://example.com/character-side.png"]
- }
- ],
+ "kling_elements": [
+ {
+ "element_input_urls": [
+ "https://example.com/character-front.png",
+ "https://example.com/character-side.png"
+ ]
+ }
+ ],
- "resolution": "1K",
- "size": "auto",
- "output_format": "png"
+ "resolution": "2K",
+ "size": "auto"
}
}
Чек-лист:
- Замените оба ID моделей O3 на
kling-4.0-image; режим редактирования теперь определяется наличиемimage_urls. - Переименуйте
elementsвkling_elementsи объединитеfrontal_image_urlиreference_image_urlsв один массивelement_input_urls, фронтальный ракурс первым, всего 2–4 URL. Элементу O3 с одним ракурсом нужен как минимум ещё один. - Уберите
output_format. Схема отклоняет неизвестные поля. - Замените
1Kна2K; задайтеsizeявно, если полагались на значение16:9по умолчанию в O3, потому что новое значение по умолчанию —auto. - Добавьте доплату за референсы в оценку стоимости.
- Увеличьте таймауты клиента или перейдите на вебхуки для 8K и серий.
Опрос статуса, разбор files[].file_url и проверка вебхуков остаются прежними. Полное описание запросов — в руководстве по Kling Image 4.0 API.
А что с Kling O1 Image?
Kling O1 Image работает только в режиме редактирования (kling-o1-image-edit) в 1K или 2K за 3.5 кредита за изображение. Рассматривайте его как kling-o3-image-edit в таблице выше: недорогая правка по референсу, без 4K и 8K, без серий.
Часто задаваемые вопросы
Является ли Kling Image 4.0 API прямой заменой Kling O3 Image API?
Почти. Эндпоинт, аутентификация, опрос и вебхуки те же. Вы меняете ID модели, переименовываете elements в kling_elements, убираете output_format и переводите запросы 1K на 2K.
Что дешевле: Kling Image 4.0 API или Kling O3 Image? Kling O3 Image: 3.5 кредита за изображение в 1K или 2K и 7 в 4K, против 13, 19 и 32 кредитов в 2K, 4K и 8K у Kling Image 4.0, который вдобавок берёт 1 кредит за каждый референс.
Поддерживает ли Kling O3 Image 8K или серии изображений?
Нет. Kling O3 Image в PoYo ограничен 4K и возвращает 1–9 независимых изображений. 8K и серии enable_sequential — возможности Kling Image 4.0 API.
Можно ли по-прежнему получать JPEG из Kling Image 4.0 API? Не из API: результат — PNG. Конвертируйте после скачивания или оставьте задачи с JPEG и WebP на Kling O3 Image.
Нужен ли новый API-ключ для Kling Image 4.0 API?
Нет. Тот же ключ PoYo работает для kling-4.0-image, kling-4.0-long-image, kling-o3-image и любой другой модели.