Skip to main content
POST
/
kling
/
v1
/
images
/
editing
/
expand
cURL
curl --request POST \
+  --url https://api.deerapi.com/kling/v1/images/editing/expand \
+  --header 'Authorization: Bearer <DEERAPI_KEY>' \
+  --header 'Content-Type: application/json' \
+  --data '{
    "image": "https://example.com/original-image.png",
    "up_expansion_ratio": 0.2,
    "right_expansion_ratio": 0.3,
    "left_expansion_ratio": 0.1,
    "bottom_expansion_ratio": 0.2,
    "prompt": "补全远景天空与地面细节。",
    "callback_url": "https://example.com/kling/callback"
  }'
{
  "image": "<string>",
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
/kling/v1/images/editing/expand 适合在保留主体和构图核心不变的前提下，向四周扩展画布。你已经有一张可用成图，只是尺寸、留白或镜头边界不够时，优先选这页。
当前 schema 要求四个扩边比例字段都传。如果某一侧不扩，显式传 0，不要直接省略该字段。

​
什么时候该用它

  • 你要把方图补成横图、竖图，或者给海报留出标题位。
  • 你想延续原图的主体和场景，而不是完全重绘。
  • 你已经有成图，不想回到文生图重新试词。

​
最小可用调用

  • 首个请求只保留 image 和四个扩边比例字段。
  • 先确认几何扩展方向是否符合预期，再决定要不要加 prompt。
  • 首轮建议用 URL 跑通，切到 Base64 时不要带 data:image/...;base64, 前缀。
  • 如果你要把结果接回自己的系统，创建时一并带上 callback_url。

​
常见误解

  • 把扩图当成局部重绘或主体替换接口。
  • 只想扩一侧，却省略其他三侧字段。
  • 扩图结果出来后没有及时转存，后续再取地址时才发现素材已经过期。

​
相关页面

  • 图像生成：你还没有主图，应该先从文生图起稿。
  • 图像识别：需要先做人物、服饰或主体分割时可以先走这页。
  • Callback 协议：扩图任务完成后由服务端主动回调。

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Headers

​
Content-Type
string

Body

application/json

当前页面不使用 model_name；如果你传 Base64，请只传 <BASE64_IMAGE_DATA>，不要附带 data:image/...;base64, 前缀。

​
image
string
default:example
required

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

​
up_expansion_ratio
number
default:1
required

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

​
right_expansion_ratio
number
default:1
required

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

​
left_expansion_ratio
number
default:1
required

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

​
bottom_expansion_ratio
number
default:1
required

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

​
prompt
string

不能超过2500个字符

​
n
string

生成图片数量

​
callback_url
string

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

​
external_task_id
string

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

Response

200 - application/json

任务已受理，返回 task_id。后续请通过同路径查询模式或 callback 获取最终扩图结果。

​
image
string
required

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

​
code
integer

Error code; specifically define the error code

​
message
string

error message

​
request_id
string

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

​
data
object