Images-expand

POST

/klingai/v1/images/editing/expand

From Kling Expansion
Official documentation: https://docs.qingque.cn/d/home/eZQAyImcbaS0fz-8ANjXvU5ed?identityId=1oEG9JKKMFv#section=h.73yk1uqg6zvj

Pricing
0.04 PTC/image

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

Request parameters for image generation service based on reference image expansion in four directions

image

string

required

Supports input of image Base64 encoding or image URL (ensure accessibility). Note: If using the base64 method, please make sure to pass the Base64 encoded string directly without adding the data:image prefix. Supported image formats are .jpg/.jpeg/.png, file size must not exceed 10MB, image resolution must be at least 300*300px, and the aspect ratio should be between 1:2.5 and 2.5:1.

Example:

iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==

up_expansion_ratio

number

required

Expand Upwards
Calculated based on a multiple of the original image height. Value range: [0,2]. The total area of the new image must not exceed 3 times that of the original image. For example, if the original image height is 20 and the current parameter value is 0.1, then the distance from the top edge of the original image to the top edge of the new image is 20 x 0.1 = 2. The area within this range is the expansion area.

>= 0<= 2

Example:

right_expansion_ratio

number

required

Expand to the right
Calculated based on a multiple of the original image height. Value range: [0,2]. The total area of the new image must not exceed 3 times the original image. For example, if the original image height is 20 and the current parameter value is 0.2, then the distance from the bottom edge of the original image to the bottom edge of the new image is 20 x 0.2 = 4. The area within this range is the expansion area.

>= 0<= 2

Example:

left_expansion_ratio

number

required

Expand range to the left
Calculated based on a multiple of the original image width. Value range: [0,2]. The total area of the new image must not exceed 3 times that of the original image. For example, if the original image width is 30 and the current parameter value is 0.3, then the distance from the left side of the original image to the left side of the new image is 30 x 0.3 = 9, and this area is the expansion range.

>= 0<= 2

Example:

down_expansion_ratio

number

required

Expand downward
Calculated based on a multiple of the original image height. Value range: [0,2]. The total area of the new image must not exceed 3 times that of the original image. For example, if the original image height is 20 and the current parameter value is 0.2, then the distance from the bottom edge of the original image to the bottom edge of the new image is 20 x 0.2 = 4. The area within this range is the expansion area.

>= 0<= 2

Example:

prompt

string

optional

Positive text prompt

integer

optional

Number of images to generate

>= 1<= 9

Example

{
    "image": "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg",
    "up_expansion_ratio": 0.1495,
    "right_expansion_ratio": 0.6547,
    "left_expansion_ratio": 0.6547,
    "down_expansion_ratio": 0.1495,
    "prompt": "白色太阳"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/klingai/v1/images/editing/expand' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image": "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg",
    "up_expansion_ratio": 0.1495,
    "right_expansion_ratio": 0.6547,
    "left_expansion_ratio": 0.6547,
    "down_expansion_ratio": 0.1495,
    "prompt": "白色太阳"
}'

Responses

🟢200成功

application/json

Body

code

integer

required

data

object

required

task_id

string

required

task_status

string

required

message

string

required

Example

{
    "code": 0,
    "data": {
        "task_id": "kling_aa4df91ec536",
        "task_status": "submitted"
    },
    "message": "SUCCEED"
}

Modified at 2025-07-16 09:17:17

Fetch（Get Task Result）

Fetch（Retrieve the results of the image upscaling task）