4Z API

扩图

接口: POST https://4zapi.com/kling/v1/images/editing/expand

参数

  • Content-Type (header, string): 请求体 Content-Type，一般为 application/json
  • Authorization (header, string): Bearer API Key

请求体 (application/json)

  • down_expansion_ratio (number, 必填): 向下扩充范围；基于原图高度的倍数而计算 取值范围：[0,2]，新图片整体面积不得超过原图片3倍 如原图高20，当前参数值为0.2，则： 原图底边距离新图底边为20 x 0.2 = 4，区域内均为扩图范围
  • image (string, 必填): 参考图片 支持传入图片Base64编码或图片URL（确保可访问）
  • left_expansion_ratio (number, 必填): 向左扩充范围；基于原图宽度的倍数而计算 取值范围：[0,2]，新图片整体面积不得超过原图片3倍 如原图宽30，当前参数值为0.3，则： 原图左边距离新图左边为30 x 0.3 = 9，区域内均为扩图范围
  • n (integer, 必填): 生成图片数量 取值范围：[1,9]
  • right_expansion_ratio (number, 必填): 向右扩充范围；基于原图宽度的倍数而计算 取值范围：[0,2]，新图片整体面积不得超过原图片3倍 如原图宽30，当前参数值为0.4，则： 原图右边距离新图右边为30 x 0.4 = 12，区域内均为扩图范围
  • up_expansion_ratio (number, 必填): 向上扩充范围；基于原图高度的倍数而计算 取值范围：[0,2]，新图片整体面积不得超过原图片3倍 如原图高20，当前参数值为0.1，则： 原图顶边距离新图顶边为20 x 0.1 = 2，区域内均为扩图范围
  • callback_url (string): 任务完成回调 URL
  • external_task_id (string): 自定义外部任务 ID（便于业务侧关联）
  • prompt (string): 正向文本提示词 不能超过2500个字符

请求示例

{
  "callback_url": "",
  "down_expansion_ratio": 0.1,
  "external_task_id": "",
  "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",
  "left_expansion_ratio": 0.1,
  "n": 1,
  "prompt": "聚焦中心",
  "right_expansion_ratio": 0.1,
  "up_expansion_ratio": 0.1
}