扩图

方法: POST路径: /kling/v1/images/editing/expand

本文档不实时更新，完整版请查看官方文档：https://app.klingai.com/cn/dev/document-api/apiReference/model/imageExpand

请求参数

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

image
string
必需
up_expansion_ratio
number
必需
down_expansion_ratio
number
必需
left_expansion_ratio
number
必需
right_expansion_ratio
number
必需
prompt
string
可选
n
integer
可选
示例
{
"image"
:
"iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
,
"up_expansion_ratio"
:
0.1
,
"down_expansion_ratio"
:
0.2
,
"left_expansion_ratio"
:
0.3
,
"right_expansion_ratio"
:
0.4
,
"prompt"
:
"扩展背景并保持风格一致"
,
"n"
:
2
,
"callback_url"
:
"https://example.com/callback"
,
"external_task_id"
:
"task_20250818_001"
}

请求示例代码

Shell

curl --location --request POST '/kling/v1/images/editing/expand' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "image": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
  "up_expansion_ratio": 0.1,
  "down_expansion_ratio": 0.2,
  "left_expansion_ratio": 0.3,
  "right_expansion_ratio": 0.4,
  "prompt": "扩展背景并保持风格一致",
  "n": 2,
  "callback_url": "https://example.com/callback",
  "external_task_id": "task_20250818_001"
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

code
integer
必需
错误码；具体定义错误码
message
string
错误信息
必需
request_id
string
必需
请求ID，系统生成，用于跟踪请求、排查问题
data
object
必需
task_id
string
任务ID，系统生成
必需
task_status
enum<string>
必需
任务状态，枚举值：submitted（已提交）、process任务创建时间，Unix时间戳、单位msing（处理中）、succeed（成功）、failed（失败）
枚举值:
submitted（已提交）
processing（处理中）
succeed（成功）
failed（失败）
created_at
integer
必需
任务创建时间，Unix时间戳、单位ms
updated_at
integer
必需
任务更新时间，Unix时间戳、单位ms

示例

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