
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 for Native 8K Images, Typography and Cohesive Sets

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"}}'
Key Capabilities of Kling Image 4.0


Up to 2,000 Characters of Multilingual Text

Cohesive Image Sets of Up to 10 Images

Up to 10 Reference Images and Custom Elements

Long-Form E-Commerce and Web Page Visuals

Unified Architecture and Detailed Prompt Support
kling-4-0/image API Parameters on Kie.ai
Parameters for POST /api/v1/jobs/createTask when model is set to kling-4-0/image.
| Parameter | Values & Rules |
|---|---|
| model | kling-4-0/image |
| prompt | Required; up to 20,000 characters in the API and playground (quote in-image text; cite @image_1… and @name) |
| image_urls | Optional; up to 10 image URLs (JPG, JPEG or PNG; max 20 MB each; aspect ratio between 2:5 and 5:2; longest side up to 8,192 px) |
| elements | Optional custom subjects ({name, image_urls[2..4], tag, description}); image_urls + elements ≤ 10 |
| mode | default (default) or series (coherent image set) |
| count | 1 to 9 in default mode (default 1); required 2 to 10 in series mode |
| resolution | 2k (default), 4k or 8k (2k/4k usually return PNG; 8k returns JPEG) |
| aspect_ratio | auto (default), 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
kling-4-0/long-image API Parameters on Kie.ai
Parameters for POST /api/v1/jobs/createTask when model is set to kling-4-0/long-image (outputs 1 long image per task; do not mix fields across skills).
| Parameter | Values & Rules |
|---|---|
| model | kling-4-0/long-image |
| skill | Required: ecommerce (product detail page) or webpage (web page design) |
| prompt | Required; up to 20,000 characters (cite @image_1… in ecommerce; @style and @subject in webpage) |
| image_urls | Required for ecommerce only: 1 to 3 product image URLs (JPG, JPEG or PNG; max 20 MB each; aspect ratio must be between 2:5 and 5:2, otherwise the task fails) |
| length | ecommerce only: short (about 2–5 sections), medium (about 6–10 sections, default) or long (about 11–18 sections) within one long image |
| style_image, subject_image | webpage only: optional JPG, JPEG or PNG URLs (max 20 MB each), cited as @style and @subject |
| resolution | 1k or 2k (default 2k) |
How to Use the Kling Image 4.0 API on Kie.ai
- 1
Step 1: Test in the Playground or Pick an Endpoint
Try prompts in the playground on this page. Use kling-4-0/image for 2K, 4K and 8K stills, reference edits and 2-to-10-image sets, or kling-4-0/long-image for single-output e-commerce detail pages and webpage designs. - 2
Step 2: Structure Prompts, References and Quotes
Put any text to render inside quotation marks. Cite image_urls in order as @image_1, @image_2 and custom subject elements as @name in kling-4-0/image, or use @style and @subject in webpage long-image tasks. - 3
Step 3: Create a Generation Task
Send a POST request to https://api.kie.ai/api/v1/jobs/createTask with an Authorization: Bearer YOUR_API_KEY header. Set model to your chosen endpoint, optionally add callBackUrl, and include the required prompt and supported settings under input: use aspect_ratio and mode with kling-4-0/image, and include the required skill field for kling-4-0/long-image. - 4
Step 4: Retrieve the Generated Image URLs
Receive completion webhooks at callBackUrl or poll GET https://api.kie.ai/api/v1/jobs/recordInfo?taskId=... to read resultUrls. For kling-4-0/image, 2K and 4K outputs usually use PNG, while 8K outputs use JPEG.