Submit Image Generation

Request

Body Params application/json

prompt

string

required

Cannot exceed 500 characters

negative_prompt

string

optional

Cannot exceed 200 characters

image

string

optional

Supports Base64 encoding or image URL, supports .jpg / .jpeg / .png format, the size cannot exceed 10MB, and the image resolution must be no less than 300*300px.

image_fidelity

number

optional

The reference strength of the user uploaded pictures during the generation process, optional, value range: [0,1]

n

number

optional

Value range: [1,9]

>= 1<= 9

aspect_ratio

string

optional

Enumeration value: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Example

{
    "prompt": "A young American female livestreamer with tears, emotional, streaming on TikTok, blue phone light reflecting on her face, bedroom background"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/kling/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A young American female livestreamer with tears, emotional, streaming on TikTok, blue phone light reflecting on her face, bedroom background"
}'

Responses

🟢200Success

application/json

Body

code

integer

required

data

object

required

created_at

integer

required

task_id

string

required

task_status

string

required

updated_at

integer

required

message

string

required

request_id

string

required

Example

{
    "code": 0,
    "data": {
        "created_at": 1747877033505,
        "task_id": "Cjz0o2gmuJkAAAAAAf-32g",
        "task_status": "submitted",
        "updated_at": 1747877033505
    },
    "message": "YEScale - Kling Image - Submit: SUCCEED",
    "request_id": "Cjz0o2gmuJkAAAAAAf-32g"
}