Skip to main content
POST
Generate image with Kling Image 4.0 Long

Kling Image 4.0 Long on BudgetPixel

More examples, prompts and pricing.

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

What the page is for and what it should hold (sections, offers, tone). For a product page, refer to the product photos as @image_1, @image_2, @image_3. The page's text follows the prompt's language.

skill
enum<string>
required

"webpage": a full webpage design (675 credits). "ecommerce": a product detail page made from 1-3 product photos (price by length).

Available options:
webpage,
ecommerce
length
enum<string>
default:medium

Product pages only: short (about 2-5 sections, 290 credits), medium (6-10, 580, the default) or long (11-18, 965). Ignored for a webpage.

Available options:
short,
medium,
long
num_images
integer
default:1

Number of pages to generate (each one is billed).

Required range: 1 <= x <= 4
reference_images
string[]

For "ecommerce": 1 to 3 product photos (required). For "webpage": up to 2, optional: the first is the subject the page features (a product, logo or person), the second a style reference. Each bills 4 credits. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads.

Maximum array length: 3

Response

Job accepted.

characters
object[]

The characters the prompt cast with @handle mentions. Absent when none.

id
string

Opaque job id — use it to poll status.

Example:

"img_a1b2c3d4e5f6"

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout