
The Kling Image 4.0 API gives developers Kling AI's newest image model through one PoYo endpoint: call kling-4.0-image for text-to-image, editing and image sets at 2K, 4K or 8K, and kling-4.0-long-image for full webpage or ecommerce page designs. This page covers what Kling Image 4.0 is, what each request field does, the limits, and what a call costs on PoYo.
What is Kling Image 4.0?
Kling Image 4.0 is the image model of the Kling 4.0 family from Kling AI, Kuaishou's AI creative platform. It was released on November 17, 2026. In its launch post, Kling says the model:
- generates images at native 8K, which Kling introduces for the first time with this model;
- creates up to 10 images from one prompt with consistent style and content;
- renders up to 2,000 characters of text in one image, in English, Simplified Chinese, Traditional Chinese, Japanese, Korean, Spanish and Portuguese;
- produces long-form images for ecommerce product detail pages and web design.
Kling also says the model is live in Kling Creative Studio and available via API to enterprises and developers. PoYo added the Kling Image 4.0 API in November 2026, with no waitlist and the same API key you use for every other PoYo model.
Kling Image 4.0 API model IDs on PoYo
| Model ID | Use it for | Output |
|---|---|---|
kling-4.0-image | Text-to-image (no image_urls), image-to-image with 1–10 references, elements, image sets | 1–9 independent images, or a set of 2–10, at 2K / 4K / 8K |
kling-4.0-long-image | skill: "webpage" page designs, skill: "ecommerce" product detail pages from 1–3 product photos | One tall image, 1024 px (1K) or 2048 px (2K) wide |
Both IDs use the same submit endpoint, the same task polling and the same callback_url webhook. The landing page slug is kling-4-0-image; the request model IDs use dots (kling-4.0-image).
Endpoint and request shape
Every Kling Image 4.0 API request is an async task:
POST https://api.poyo.ai/api/generate/submitwithAuthorization: Bearer $POYO_API_KEYand a JSON body ofmodelplusinput.- Read
data.task_idfrom the response. - Poll
GET https://api.poyo.ai/api/generate/status/{task_id}untilstatusisfinishedorfailed, or passcallback_urlat the top level and receive a POST when the task ends.
A minimal 4K request, copied from the docs shape:
{
"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"
}
}
A finished task returns the images in data.files, each with file_url and file_type: "image". Image sets come back in order. Check the code field in the body as well as the HTTP status: PoYo can return HTTP 200 with code: 400 for a validation error. The step-by-step version with cURL and Python is in the Kling Image 4.0 API guide.
Input fields and limits
kling-4.0-image
| Field | Values | Notes |
|---|---|---|
prompt | 1–50,000 characters | Required. Refer to inputs as @Image1, @Element1 |
image_urls | 1–10 URLs | Selects image-to-image. Each image up to 30 MB, at least 300 px per side, aspect ratio 0.4–2.5 |
kling_elements | up to 7 elements | Each {"element_input_urls": [...]} with 2–4 views, frontal first. Needs image_urls. Images plus elements ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Default auto |
resolution | 2K, 4K, 8K | Default 2K. 8K is 8192×8192 at 1:1 |
enable_sequential | true / false | true returns a coherent image set |
n | 1–9 (independent) or 2–10 (set) | Defaults 1 and 4 |
The schema rejects unknown fields, so do not send output_format, seed or negative_prompt. Output is PNG.
kling-4.0-long-image
| Field | Values | Notes |
|---|---|---|
skill | webpage (default), ecommerce | Selects the page type |
image_urls | 1–3 product photos | Required for ecommerce |
style_image_url / subject_image_url | one URL each | webpage only; @StyleImage, @SubjectImage |
length | short, medium (default), long | ecommerce only: about 2–5, 6–10 or 11–18 sections |
resolution | 1K (default), 2K | Width 1024 or 2048 px; height follows the content |
Each long-image request returns one image.
Kling Image 4.0 API pricing on PoYo
PoYo bills per generated image (1 credit = $0.005). Credits are charged only when the task succeeds.
| Request | Credits | USD |
|---|---|---|
kling-4.0-image, 2K, per image | 13 | $0.065 |
kling-4.0-image, 4K, per image | 19 | $0.095 |
kling-4.0-image, 8K, per image | 32 | $0.16 |
Each image_urls item and each kling_elements element, once per request | 1 | $0.005 |
| Long image, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Long image, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Long image, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Long image, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Long image, each image in image_urls, style_image_url or subject_image_url | 1 | $0.005 |
The pricing breakdown has the long-image tables and worked examples.
What we measured on launch day
The PoYo team ran these requests on the production API on November 19, 2026. Times are submit to result as seen by a polling client, so treat them as approximate.
| Request | Output | Cost | Time |
|---|---|---|---|
kling-4.0-image, text-to-image, 16:9, 8K, n: 1 | 10880×6144 PNG, about 128 MB | 32 credits | about 3.8 min |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | four 2720×1536 images, same rider, bike and outfit from dawn to night | 52 credits | about 4.9 min |
kling-4.0-long-image, skill: "webpage", 1K | one 1024×4257 page | 110 credits | about 1.7–2.2 min |
Two integration notes from the same run. Downloads were PNG files with an alpha channel (RGBA) even for opaque images, so convert explicitly if your pipeline expects RGB or JPEG. And a long webpage prompt in English that did not name a language for the page copy came back with Chinese text; adding "All text on the page is in English." fixed it. More on both in 8K and long images.
Which requests should go to the Kling Image 4.0 API?
- Print, billboard and crop-heavy work that needs more than 4K: it is the only image model on PoYo with an
8Ktier. - Storyboards, product angles and slide decks where one character or product must stay the same across frames: use
enable_sequential. - Placing a known product or character into a new scene: pass the scene in
image_urlsand the subject as a multi-angle element. - Landing page mockups and ecommerce detail pages as one image:
kling-4.0-long-image.
For quick 1K–2K drafts at the lowest price, Kling O3 Image is cheaper per image; see Kling Image 4.0 API vs Kling O3 Image. To weigh it against other vendors, read Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Frequently asked questions
What is the Kling Image 4.0 API?
It is PoYo's REST access to Kling AI's Kling Image 4.0 model, under the model IDs kling-4.0-image (standard images, edits and image sets) and kling-4.0-long-image (long webpage and ecommerce pages). Both use POST /api/generate/submit and the same API key.
How much does the Kling Image 4.0 API cost? 13 credits ($0.065) per image at 2K, 19 credits ($0.095) at 4K and 32 credits ($0.16) at 8K, plus 1 credit ($0.005) per reference image or element once per request. Long images cost 47 to 173 credits per page. Failed tasks are not charged.
Does the Kling Image 4.0 API support image-to-image?
Yes. Pass 1 to 10 URLs in image_urls with kling-4.0-image and refer to them in the prompt as @Image1, @Image2. Add up to 7 kling_elements for consistent characters or objects; images plus elements are capped at 10.
How long does a Kling Image 4.0 API request take?
In our launch-day test, one 16:9 8K image took about 3.8 minutes, a four-image 2K set about 4.9 minutes and a 1K webpage about 2 minutes. Use callback_url instead of holding a request open for large jobs.
Where are the Kling Image 4.0 API docs? The field reference is in the Kling Image 4.0 docs and the long image docs. The model page has a playground that shows the JSON for your settings.