主题
图像扩展(Outpainting)
向图片的四个方向扩展指定像素,由 AI 补全扩展区域。默认 2.0:可传 userPrompt 补充要求;不传则由视觉模型根据扩展边写提示。传 engine=v1 则走 1.0,并把 userPrompt 当作扩图提示。
在编辑器中试用:智能扩图。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/outpainting |
| 所需 Scope | outpainting 或 * |
| 任务类型 | 异步,返回 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": "可选的内容描述提示"
}参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
requestId | string | 否 | 调用方请求 ID,用于幂等去重。省略时服务端生成,并在响应里返回 |
url | string | 是 | 原图的公开 HTTPS URL |
leftExpand | integer | 否 | 向左扩展的像素数 |
rightExpand | integer | 否 | 向右扩展的像素数 |
topExpand | integer | 否 | 向上扩展的像素数 |
bottomExpand | integer | 否 | 向下扩展的像素数 |
engine | string | 否 | v2(默认)或 v1(1.0)。未传或其他值按 2.0 |
outputResolution | string | 否 | 计费档位,不改变出图像素。能读到原图尺寸时,按原图加四边重算为 1k / 1.5k / 2k。engine=v1 时忽略。OpenAPI 仍按 1 个 API_CALL 计费 |
userPrompt | string | 否 | 可选扩图要求。2.0 最多 100 字,超长截断;空或省略则由视觉模型根据扩展边写提示。1.0 把这段文字当作扩图提示;空则不附加 |
meta | string | 否 | 调用方可附带的描述信息 |
四边省略或小于 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作为扩图提示。
