扩图 - API reference

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

基于参考图片进行向四个方向扩充的图片生成服务请求参数

image

string

参考图片

必需

支持传入图片Base64编码或图片URL（确保可访问）。注意：若使用base64方式，请确保直接传递Base64编码字符串，不要添加data:image前缀。图片格式支持.jpg/.jpeg/.png，文件大小不能超过10MB，图片分辨率不小于300*300px，图片宽高比要在1:2.5 ~ 2.5:1之间

示例值:

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

up_expansion_ratio

number

向上扩充范围

必需

基于原图高度的倍数而计算。取值范围：[0,2]，新图片整体面积不得超过原图片3倍。如原图高20，当前参数值为0.1，则原图顶边距离新图顶边为20 x 0.1 = 2，区域内均为扩图范围

>= 0<= 2

默认值:

0

示例值:

00.10.512

bottom_expansion_ratio

number

向下扩充范围

必需

基于原图高度的倍数而计算。取值范围：[0,2]，新图片整体面积不得超过原图片3倍。如原图高20，当前参数值为0.2，则原图底边距离新图底边为20 x 0.2 = 4，区域内均为扩图范围

>= 0<= 2

默认值:

0

示例值:

00.20.512

left_expansion_ratio

number

向左扩充范围

必需

基于原图宽度的倍数而计算。取值范围：[0,2]，新图片整体面积不得超过原图片3倍。如原图宽30，当前参数值为0.3，则原图左边距离新图左边为30 x 0.3 = 9，区域内均为扩图范围

>= 0<= 2

默认值:

0

示例值:

00.30.512

right_expansion_ratio

number

向右扩充范围

必需

基于原图宽度的倍数而计算。取值范围：[0,2]，新图片整体面积不得超过原图片3倍。如原图宽30，当前参数值为0.4，则原图右边距离新图右边为30 x 0.4 = 12，区域内均为扩图范围

>= 0<= 2

默认值:

0

示例值:

00.40.512

prompt

string

正向文本提示词

可选

不能超过2500个字符

<= 2500 字符

示例值:

美丽的风景，高画质，细节丰富sunset landscape, detailed, high quality

n

integer

生成图片数量

可选

取值范围：[1,9]

>= 1<= 9

默认值:

1

示例值:

1249

callback_url

string <uri>

回调通知地址

可选

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知。具体通知的消息schema见Callback协议

示例值:

https://your-domain.com/callbackhttps://api.example.com/webhook/image-expansion

external_task_id

string

自定义任务ID

可选

用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。请注意，单用户下需要保证唯一性

示例值:

user_task_001my_expansion_task_20240101custom_id_12345

示例

{
    "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": "白色太阳"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/kling/v1/images/editing/expand' \
--header 'Authorization: ' \
--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": "白色太阳"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}