POST/kling/v1/images/editing/expand

扩图

API Key application/json

Request

请求

/kling/v1/images/editing/expand

Body

必填

Bodyobject

imagestring必填

参考图片支持传入图片Base64编码或图片URL（确保可访问）

up_expansion_rationumber必填

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

down_expansion_rationumber必填

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

left_expansion_rationumber必填

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

right_expansion_rationumber必填

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

promptstring

正向文本提示词不能超过2500个字符

ninteger必填

生成图片数量取值范围：[1,9]

callback_urlstring

external_task_idstring

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	否	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/kling/v1/images/editing/expand \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
  "up_expansion_ratio": 0.1,
  "down_expansion_ratio": 0.1,
  "left_expansion_ratio": 0.1,
  "right_expansion_ratio": 0.1,
  "prompt": "聚焦中心",
  "n": 1,
  "callback_url": "",
  "external_task_id": ""
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

扩图

请求

Body

路径、查询与 Header 参数

返回响应 200

返回响应 `200`