Skip to main content
POST
Kling O1 Image
Precise editing, strong reference control, visual consistency.

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

prompt
string
required

Text prompt for image generation. Reference images using @Image1, @Image2, etc. (or @Image if only one image). Reference elements using @Element1, @Element2, etc.

Maximum string length: 2500
image_urls
string<uri>[] | null

List of reference images. Reference images in prompt using @Image1, @Image2, etc. (1-indexed). Combined with elements, up to 10 items total.

Maximum array length: 10
elements
Elements · object[] | null

Elements with optional reference images and a frontal image. Reference elements in prompt using @Element1, @Element2, etc. (1-indexed). Combined with image_urls, up to 10 items total.

Maximum array length: 10
resolution
enum<string>
default:1K

Image generation resolution. 1K: standard, 2K: high-res.

Available options:
1K,
2K
aspect_ratio
enum<string>
default:16:9

Aspect ratio of generated images. 'auto' intelligently determines based on input content.

Available options:
auto,
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
output_format
enum<string>
default:png

The format of the generated image.

Available options:
jpeg,
png,
webp
n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.