About Kling Image 4.0 Long
A full product detail or landing page as one tall image, from text or product photos.
Call it with the model name kling/image-4.0-long/edit on POST /jobs/createTask, from $0.238.
Introduction
Build a product story around supplied photos
This endpoint takes product photography and a merchandising brief, then composes a continuous detail-page image. Use it when a shopper should see the item, understand the supplied selling points and follow the information through a sequence of modules. Bring the product facts with the photos; the brief should define what the page is being asked to communicate.
Unlike webpage design, this task requires product photos and provides a page length control. The result is a flat page visual for review or preparation as a listing graphic. It does not provide an editable storefront or a set of separate module files.
Product inputs and page controls
Prepare the images and checked copy before choosing the length and resolution.
| Parameter | Requirement | Purpose |
|---|---|---|
prompt | Required string, 1 to 71,000 characters | Provide product facts, selling points and module order; refer to photos with @image_1, @image_2. |
image_urls | Required array of 1 to 3 photos | Use JPG or PNG files up to 30 MB, at least 300 px per side, with a ratio between 2:5 and 5:2. |
page_length | Optional: short, medium or long; default medium | Select how long the detail page runs. |
resolution | Optional: 1k or 2k; default 1k | Choose the output tier independently of the length. |
Set the page length to suit the amount of product information you want to present. Choose resolution separately, then review the resulting image with its intended storefront placement in mind.
Choose photos for the information they carry
Show the product clearly and explain what each numbered image contributes, such as its overall appearance or a close view of a detail. Distinguish information visible in a photo from specifications supplied as text. Explain which view should introduce the product and which should support a detail module, keeping each photo connected to a clear part of the page.
Assemble the merchandising brief
Start with the product identity and verified facts. Then list the modules in the order a shopper should encounter them: a hero, the supplied selling points, supporting product details and a closing panel. Include care instructions when you have checked wording to provide. Do not ask the model to invent dimensions, materials or claims to fill an empty section.
Write copy that can be checked
Quote the headline and the text for each information block, with its intended section beside it. Where a fact is missing, omit it from the requested copy. A list of broad adjectives gives a reviewer little to verify; a supplied statement about a product feature can be compared directly with the returned image. Keep facts, visual direction and module order clearly expressed in the brief.
Match the content budget to the length
Use the selector to request short, medium or long and write a brief that fits the chosen scope. A compact page can focus on a concise product introduction, while a longer brief can allocate room to additional supplied information. Give each module a distinct purpose and remove repeated selling points before submitting the prompt. Changing resolution is a separate decision and should not substitute for editing down crowded copy.
Observations from the preserved-rose run
Our November 18, 2026 request supplied one rose photo and asked for a hero shot, three selling points, care instructions and a closing gift message panel in an amber and ivory palette. Its controls selected short length and 1k resolution. The brief connected the product photo to a sequence from introduction through care and gifting.
The response contained one 1024 x 5021 PNG laid out as a short product detail page around the supplied rose photo. Check the product appearance through the sequence and compare the selling points, care text and closing message with your supplied wording before preparing the page for shoppers.
Request parameters
| Parameter | Required | Description |
|---|---|---|
image_urls | Yes | Photos to edit or combine. Say in the prompt what each one adds. |
page_length | No | How long the finished detail page runs; the price follows this choice. short · medium · long · Default: medium |
prompt | Yes | Describe what you want to make. |
resolution | No | Choose an available output size. 1k · 2k · Default: 1k |
Pricing
Prices are in USD and charged to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per image |
|---|---|
| page_length short · resolution 1K | $0.235 |
| page_length short · resolution 2K | $0.282 |
| page_length medium · resolution 1K | $0.47 |
| page_length medium · resolution 2K | $0.549 |
| page_length long · resolution 1K | $0.784 |
| page_length long · resolution 2K | $0.862 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
API quick start
Call the Kling Image 4.0 Long API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls are billed in USD from your PopNow balance.
- Send the request. POST /jobs/createTask with model kling/image-4.0-long/edit and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "kling/image-4.0-long/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"page_length": "medium",
"resolution": "1k"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
Kling Image 4.0 Long API questions
How much does the Kling Image 4.0 Long API cost?
Kling Image 4.0 Long costs $0.238 per image. Prices by option: short · 1K $0.235 per image, short · 2K $0.282 per image, medium · 1K $0.47 per image, medium · 2K $0.549 per image. API usage is charged in USD to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What is the model name for Kling Image 4.0 Long in the API?
Put kling/image-4.0-long/edit for Long Image; kling/image-4.0-long/text-to-image for Long Image in the model field of POST /jobs/createTask.
Do I get working website code?
No. Kling Image 4.0 Long returns a picture of the page, which works as a design direction or a listing graphic.
Can I generate a detail page without a product photo?
No. The e-commerce skill needs at least one photo so the page can show your actual product.
Does page length affect webpage design?
No. The short, medium and long choices belong to product detail pages. Write the website section order in the prompt; this endpoint has no page length selector.
How should I specify headings and body copy?
Quote the exact words beside the section where they belong. Include the audience and section order for a website, or verified product facts and selling points for a detail page. Compare all rendered copy with your brief before reuse, especially small text.
How do I refer to uploaded images in a prompt?
Use numbered references such as @image_1 and @image_2. Explain whether each image supplies a product, a subject or a style direction, within the role of the selected endpoint. The Tideline run used its reference for a warm amber accent; the rose run used its reference as the product photo.
What are the limits of the Kling Image 4.0 Long API?
Resolutions: 1K · 2K; Reference images: 3; Prompt length (characters): 71,000; Largest upload: 30 MB. Requests outside these limits are rejected before anything is charged.
Can I try Kling Image 4.0 Long without writing code?
Run Kling Image 4.0 Long in the Playground with your API USD balance, without an API key. Each run appears in your developer history with its matching code.
All Kling models
- Kling 4.0 APIUp to 30-second 1080p clips with keyframes, edits and extensions; may queue when busyFrom $0.45 for a 5-second clip
- Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom $0.34 for a 5-second clip
- Kling Image 4.0 APINative 2K, 4K or 8K stills with readable lettering, plus edits from up to ten referencesFrom $0.063 per image
- Kling Image 4.0 Set APITwo to ten matching images from one brief, with the same character, product and paletteFrom $0.063 per image
- Kling Image 4.0 Long APIA full product detail or landing page as one tall image, from text or product photosFrom $0.238 per image
- Kling 4.0 Flash APIFast 720p Kling clips with sound, 3 to 20 secondsFrom $0.564 for a 5-second clip
- Kling 3.0 Turbo APIFaster Kling 3.0 with sound on every clipFrom $0.55 for a 5-second clip
- Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom $0.34 for a 5-second clip
- Kling Avatar 2.0 APIA portrait that speaks or sings your audio, up to 5 minutesFrom $0.055 per second
- Kling 2.6 API1080p clips with optional sound and motion controlFrom $0.345 for a 5-second clip
- Kling 2.5 Turbo API1080p clips with a soundtrack on every takeFrom $0.345 for a 5-second clip
- Kling 2.1 Master APISilent 1080p clips with fine prompt controlFrom $1.385 for a 5-second clip
- Kling 2.1 APIAnimate a frame at 720p or 1080p, with an optional end frameFrom $0.275 for a 5-second clip