Expanded

POST

https://api.cometapi.com/kling/v1/images/editing/expand

Maintainer:Not configured

This document is not updated in real time; for the complete version, please refer to the official documentation: https://app.klingai.com/cn/dev/document-api/apiReference/model/textToVideo

Request

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Content-Type

string

optional

Example:

application/json

Body Params application/json

image

string

Reference Image

required

Supports input of image Base64 encoding or image URL (ensure it is accessible). Note: If using Base64, please pass the Base64 encoded string directly; do not add the data:image prefix. Supported image formats: .jpg/.jpeg/.png. File size must not exceed 10MB. Image resolution must be no less than 300*300px, and the image aspect ratio should be between 1:2.5 and 2.5:1.

Examples:

iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==https://example.com/image.jpg

up_expansion_ratio

number

Upward Expansion Range

required

Calculated based on a multiple of the original image height. Value range: [0,2]. The overall 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 distance is the expansion range.

>= 0<= 2

Examples:

00.10.512

bottom_expansion_ratio

number

Downward Expansion Range

required

Calculated based on a multiple of the original image height. Value range: [0,2]. The overall 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 distance is the expansion range.

left_expansion_ratio

number

Leftward Expansion Range

required

Calculated based on a multiple of the original image width. Value range: [0,2]. The overall 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 edge of the original image to the left edge of the new image is 30 x 0.3 = 9; the area within this distance is the expansion range.

>= 0<= 2

Examples:

00.10.512

right_expansion_ratio

number

Rightward Expansion Range

required

Calculated based on a multiple of the original image width. Value range: [0,2]. The overall 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.4, then the distance from the right edge of the original image to the right edge of the new image is 30 x 0.4 = 12; the area within this distance is the expansion range.

>= 0<= 2

Examples:

00.10.512

prompt

string

optional

Must not exceed 2500 characters

<= 2500 characters

Example:

sunset landscape, detailed, high quality

string

optional

Number of images to generate

>= 1 characters<= 9 characters

Examples:

callback_url

string

optional

Callback notification address for the result of this task. If configured, the server will proactively notify when the task status changes. For the schema of the notification message, see the Callback protocol.

Example:

https://your-domain.com/callback

external_task_id

string

optional

User-defined task ID. Providing this will not overwrite the system-generated task ID, but it can be used to query the task. Please ensure uniqueness under the same user.

Example:

user_task_001

Example

{
    "image": "https://storage.fonedis.cc/upload_1750935799477317519.png",
    "up_expansion_ratio": 0.1495,
    "right_expansion_ratio": 0.6547,
    "left_expansion_ratio": 0.6547,
    "down_expansion_ratio": 0.1495,
    "prompt": "white sun"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cometapi.com/kling/v1/images/editing/expand' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image": "https://storage.fonedis.cc/upload_1750935799477317519.png",
    "up_expansion_ratio": 0.1495,
    "right_expansion_ratio": 0.6547,
    "left_expansion_ratio": 0.6547,
    "down_expansion_ratio": 0.1495,
    "prompt": "white sun"
}'

Responses

🟢200Successful Response

application/json

Body

code

integer

Error code; specifically define error code

optional

Error code; specifically define the error code

image

string

required

Supports passing in an image Base64-encoded string or image URL (ensure it is accessible). Note: If using Base64, 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 no less than 300*300px, and the aspect ratio must be between 1:2.5 and 2.5:1

Examples:

iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==https://example.com/image.jpg

message

string

Error message

optional

error message

request_id

string

Request ID, system generated, used for tracking requests, troubleshooting issues

optional

Request ID, system-generated, for tracking requests, troubleshooting issues

data

object

optional

task_id

string

Task ID, system generated

required

Task ID, system generated

task_status

string

Task status, enumerated values: submitted (submitted), processing (processing), succeed (succeed), failed (failed)

required

Task status, enumerated values: submitted, processing, succeed, failed.

created_at

integer

Task creation time, Unix timestamp, unit ms

required

Task creation time, Unix timestamp, in ms.

updated_at

integer

Task update time, Unix timestamp, unit ms

required

Task update time, Unix timestamp, in ms.

Example

{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}

callback_url

Generating images