Skip to content

图像扩展(Outpainting) ​

向图片的四个方向扩展指定像素,由 AI 补全扩展区域。默认 2.0:可传 userPrompt 补充要求;不传则由视觉模型根据扩展边写提示。传 engine=v1 则走 1.0,并把 userPrompt 当作扩图提示。

在编辑器中试用:智能扩图。

基本信息 ​

项目值
接口路径POST /image/outpainting
所需 Scopeoutpainting 或 *
任务类型异步,返回 taskId
输出尺寸原图加上四边扩展像素,最多到 2K(长边 2048 且不超过 4MP)。不按 1K/1.5K/2K 重采样

请求参数 ​

json
{
  "requestId": "可选,调用方自定义唯一 ID",
  "url": "原图的公开 HTTPS URL(必填)",
  "leftExpand": 100,
  "rightExpand": 100,
  "topExpand": 100,
  "bottomExpand": 100,
  "engine": "可选,v2(默认)或 v1",
  "userPrompt": "可选。2.0 空或省略则由视觉模型根据扩展边写提示;1.0 把这段文字当作扩图提示",
  "meta": "可选的内容描述提示"
}

参数说明 ​

参数类型必填说明
requestIdstring否调用方请求 ID,用于幂等去重。省略时服务端生成,并在响应里返回
urlstring是原图的公开 HTTPS URL
leftExpandinteger否向左扩展的像素数
rightExpandinteger否向右扩展的像素数
topExpandinteger否向上扩展的像素数
bottomExpandinteger否向下扩展的像素数
enginestring否v2(默认)或 v1(1.0)。未传或其他值按 2.0
outputResolutionstring否计费档位,不改变出图像素。能读到原图尺寸时,按原图加四边重算为 1k / 1.5k / 2k。engine=v1 时忽略。OpenAPI 仍按 1 个 API_CALL 计费
userPromptstring否可选扩图要求。2.0 最多 100 字,超长截断;空或省略则由视觉模型根据扩展边写提示。1.0 把这段文字当作扩图提示;空则不附加
metastring否调用方可附带的描述信息

四边省略或小于 0 时按 0。都为 0 时没有扩展区域,请求仍会提交。传入原图 URL 和扩展像素即可,不要先把画布垫大再传。本地图片先 POST /images/upload,把返回的 data.url 作为 url。


请求示例 ​

向右下各扩展 200px(默认 2.0):

bash
curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "rightExpand": 200,
    "bottomExpand": 200
  }' \
  "https://magiqsight.com/openapi/v1/image/outpainting"

2.0 带扩图要求:

bash
curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "leftExpand": 100,
    "rightExpand": 100,
    "topExpand": 100,
    "bottomExpand": 100,
    "userPrompt": "把桌面纹理接下去"
  }' \
  "https://magiqsight.com/openapi/v1/image/outpainting"

1.0 旧版扩图:

bash
curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "engine": "v1",
    "rightExpand": 200,
    "bottomExpand": 200
  }' \
  "https://magiqsight.com/openapi/v1/image/outpainting"

响应示例 ​

json
{
  "code": 0,
  "data": {
    "requestId": "req_abc123",
    "taskId": "task_xyz"
  },
  "msg": ""
}

获得 taskId 后,通过 GET /tasks/{taskId} 轮询结果。

任务成功(status: 1)后,resultType 为 image,结果在 imageUrls。任务失败(status: 2)时,原因在 resultMetadata。

默认 2.0。不传 userPrompt 时由视觉模型根据扩展边写提示。要 1.0 时传 "engine": "v1",此时 userPrompt 作为扩图提示。

妙图设计 API Beta