Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Kling Image O1 (POST /images/omni-image, model_name=kling-image-o1). No result_type/series_amount. Element is not exposed. Default aspect_ratio is 1:1 when omitted.

​
prompt
string
required

Text prompt (positive/negative in one field). May reference images as <<<image_1>>> etc. Max 2500 characters.

Required string length: 1 - 2500
Example:

"Merge all the people into the <<<image_1>>> scene"

​
images
string[]

Optional reference images (flattened image_list). Omit for pure text-to-image. If provided, must contain 1-10 non-empty URLs/Base64 strings.

Required array length: 1 - 10 elements

Image URL or Base64 (JPG/JPEG/PNG, ≤10MB, ≥300px, aspect 1:2.5~2.5:1)

Minimum string length: 1
Example:
​
resolution
enum<string>
default:1k

Output resolution. Capability Map for O1: 1k | 2k only (no 4k).

Available options:
1k,
2k
Example:

"2k"

​
aspect_ratio
enum<string>
default:1:1

Aspect ratio. Default 1:1 when omitted (filled by platform).

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
Example:

"1:1"

​
n
integer
default:1

Number of images to generate [1, 9].

Required range: 1 <= x <= 9
Example:

1

Response

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required

Detailed data about the submitted asynchronous task.