Skip to main content
POST
/
kling
/
v1
/
images
/
omni-image
Kling omni image task
curl --request POST \
  --url https://api.powertokens.ai/kling/v1/images/omni-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v3-omni",
  "prompt": "Create a three-frame product storyboard",
  "result_type": "series"
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": "<string>"
    },
    "created_at": 123,
    "updated_at": 123
  },
  "request_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <token> in the request header.

Body

application/json
​
model_name
enum<string>
required

Model name

Available options:
kling-v3-omni
​
prompt
string
required

Text prompt, can include positive and negative descriptions

  • Prompts can be templated to meet different image generation needs
  • Must not exceed 2500 characters
  • Reference images using the <<<>>> format, e.g.: <<<image_1>>>
Maximum string length: 2500
​
image_list
object[]

Reference image list, passed as key:value pairs:

"image_list": [{ "image": "image_url" }]
  • Supports image Base64 encoding or image URL (must be accessible)
  • Supported image formats: .jpg / .jpeg / .png
  • Image file size must not exceed 10MB, image dimensions must be at least 300px, aspect ratio between 1:2.5 ~ 2.5:1
  • The total of reference elements and reference images must not exceed 10
  • The image_url value must not be empty
​
element_list
object[]

Element reference list, configured based on element IDs in the element library

  • Passed as key:value pairs: "element_list":[{ "element_id": 829836802793406551 }]

  • The total of reference elements and reference images must not exceed 10

​
resolution
enum<string>
default:1K

Generated image resolution

Available options:
1k,
2k,
4K
​
result_type
enum<string>
default:single

Toggle between single image / series image output

Available options:
single,
series
​
aspect_ratio
enum<string>
default:auto

Aspect ratio of generated images (width:height)

Values: 16:9 9:16 1:1 4:3 3:4 3:2 2:3 21:9 auto

  • auto: intelligently selects aspect ratio based on input content
Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9,
auto
​
n
integer

Number of images to generate

  • Range: [1, 9]
  • When result_type is series, this parameter has no effect
Required range: 1 <= x <= 9
​
series_amount

Number of images in the generated series

Values: 2 3 4 5 6 7 8 9 auto

  • auto: intelligently selects the number of images based on input content
  • When using auto, it consumes concurrency quota equal to the actual number generated
  • When result_type is single, this parameter has no effect
Required range: 2 <= x <= 9
​
watermark_info
object

Whether to also generate a watermarked result.

​
callback_url
string

Callback notification URL for this task. If configured, the server will proactively notify when the task status changes.

​
external_task_id
string

Custom task ID

  • User-defined task ID; providing one does not override the system-generated task ID, but the task can be queried using this ID
  • Must be unique per user

Response

Task accepted.

​
code
integer
required

Kling response code. 0 indicates the task has been accepted.

​
message
string
required

Kling response message.

​
data
object
required
​
request_id
string

Upstream request identifier (if provided).