
Required. E-commerce: reference product images as @image_1, @image_2 ... Webpage: reference the style image as @style and the subject image as @subject. Any @ followed by letters/digits/underscore/Chinese is treated as a reference; use a full-width @ or add a space after @ for emails or handles.
0/20000ecommerce: product detail page (1-3 product images required). webpage: web page design (optional style and subject images).
Click to upload or drag and drop
Supported formats: PNG, JPEG Maximum file size: 20MB; Maximum files: 3
E-commerce only. 1-3 product images, referenced in the prompt as @image_1, @image_2 ... in upload order. Recommended: width and height >= 300px, aspect ratio between 2:5 and 5:2.
E-commerce only. short: about 2-5 sections; medium: about 6-10 sections; long: about 11-18 sections. Sections are content blocks within one long image, not separate images.
Output resolution.

Explore different use cases and parameter configurations
Text prompt (required). Reference uploaded images as @image_1, @image_2 ... in upload order, and elements as @name. Put any text that should appear in the image inside quotation marks.
0/20000Click to upload or drag and drop
Supported formats: PNG, JPEG Maximum file size: 20MB; Maximum files: 10
Optional reference images (up to 10). Leave empty for text-to-image; upload images for image-to-image and reference them in the prompt as @image_1, @image_2 ...
Optional subjects created for this task, referenced in the prompt as @name. Each element needs 2-4 images. image_urls and elements together cannot exceed 10.
default: standard generation (1-9 images). series: generate a coherent set of 2-10 images.
Output resolution.
Aspect ratio of the output image.
Number of images. Default mode: 1-9 (default 1). Series mode: 2-10, required.

Explore different use cases and parameter configurations
README
Complete guide to using Kling Image 4.0
Kling Image 4.0 API для изображений в нативном 8K, типографики и согласованных серий

curl https://api.kie.ai/api/v1/jobs/createTask \-H "Authorization: Bearer $KIE_API_KEY" \-H "Content-Type: application/json" \-d '{"model": "kling-4-0/image","input": {"prompt": "A faceted glass perfume bottle on wet slate, studio lighting","resolution": "2k","aspect_ratio": "16:9"}}'
Ключевые возможности Kling Image 4.0


До 2 000 символов текста на разных языках

Согласованные серии до 10 изображений

До 10 референсных изображений и пользовательских elements

Длинные макеты для интернет-магазинов и веб-страниц

Единая архитектура и поддержка подробных запросов
Параметры API kling-4-0/image на Kie.ai
Параметры POST /api/v1/jobs/createTask, когда model задан как kling-4-0/image.
| Parameter | Значения и правила |
|---|---|
| model | kling-4-0/image |
| prompt | Обязательный; до 20 000 символов в API и тестовой среде (текст для изображения заключайте в кавычки; ссылайтесь на @image_1… и @name) |
| image_urls | Необязательный; до 10 URL изображений (JPG, JPEG или PNG; не более 20 МБ каждое; соотношение сторон от 2:5 до 5:2; длинная сторона — до 8 192 px) |
| elements | Необязательные пользовательские объекты ({name, image_urls[2..4], tag, description}); image_urls + elements ≤ 10 |
| mode | default (по умолчанию) или series (согласованная серия изображений) |
| count | От 1 до 9 в режиме default (по умолчанию 1); в режиме series обязательно от 2 до 10 |
| resolution | 2k (по умолчанию), 4k или 8k (2k/4k обычно возвращают PNG; 8k возвращает JPEG) |
| aspect_ratio | auto (по умолчанию), 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
Параметры API kling-4-0/long-image на Kie.ai
Параметры POST /api/v1/jobs/createTask, когда model задан как kling-4-0/long-image (возвращает 1 длинное изображение на задачу; не смешивайте поля для разных значений skill).
| Parameter | Значения и правила |
|---|---|
| model | kling-4-0/long-image |
| skill | Обязательный: ecommerce (страница с подробным описанием товара) или webpage (дизайн веб-страницы) |
| prompt | Обязательный; до 20 000 символов (ссылайтесь на @image_1… в ecommerce; на @style и @subject в webpage) |
| image_urls | Обязательный только для ecommerce: от 1 до 3 URL изображений товара (JPG, JPEG или PNG; не более 20 МБ каждое; соотношение сторон должно быть от 2:5 до 5:2, иначе задача завершится с ошибкой) |
| length | только для ecommerce: short (около 2–5 блоков), medium (около 6–10 блоков, по умолчанию) или long (около 11–18 блоков) в одном длинном изображении |
| style_image, subject_image | только для webpage: необязательные URL файлов JPG, JPEG или PNG (до 20 МБ каждый), указываются как @style и @subject |
| resolution | 1k или 2k (по умолчанию 2k) |
Как использовать Kling Image 4.0 API на Kie.ai
- 1
Шаг 1. Протестируйте в песочнице или выберите эндпоинт
Проверьте промпты в песочнице на этой странице. Используйте kling-4-0/image для статичных кадров в 2K, 4K и 8K, редактирования по референсам и серий из 2–10 изображений или kling-4-0/long-image для карточек товаров и макетов веб-страниц, генерируемых одним длинным изображением. - 2
Шаг 2. Оформите промпты, референсы и кавычки
Любой текст, который нужно отрисовать на изображении, заключайте в кавычки. В kling-4-0/image ссылайтесь на image_urls по порядку как @image_1, @image_2, а на пользовательские объекты из elements — как @name; в задачах на длинные макеты веб-страниц используйте @style и @subject. - 3
Шаг 3. Создайте задачу генерации
Отправьте POST-запрос на https://api.kie.ai/api/v1/jobs/createTask с заголовком Authorization: Bearer YOUR_API_KEY. Укажите выбранный эндпоинт в поле model, при необходимости добавьте callBackUrl и передайте обязательный prompt и поддерживаемые настройки в объекте input: для kling-4-0/image используйте aspect_ratio и mode, а для kling-4-0/long-image укажите обязательное поле skill. - 4
Шаг 4. Получите URL сгенерированных изображений
Принимайте вебхуки о завершении на callBackUrl или опрашивайте GET https://api.kie.ai/api/v1/jobs/recordInfo?taskId=..., чтобы получить resultUrls. В kling-4-0/image результаты в 2K и 4K обычно возвращаются в формате PNG, а в 8K — в JPEG.