图像扩展（Outpainting）

向图片的四个方向扩展指定像素，由 AI 自动补全扩展区域的内容，使图像自然延伸。

基本信息

项目	值
接口路径	POST /image/outpainting
所需 Scope	outpainting 或 *

| 任务类型 | 异步，返回 taskId |

---

请求参数

{
  "requestId": "可选，调用方自定义唯一 ID",
  "url": "原图的公开 HTTPS URL（必填）",
  "leftExpand": 100,
  "rightExpand": 100,
  "topExpand": 100,
  "bottomExpand": 100,
  "meta": "可选的内容描述提示"
}

参数说明

参数	类型	必填	说明
requestId	string	否	调用方请求 ID，用于幂等去重
url	string	是	原图的公开 HTTPS URL
leftExpand	integer	否	向左扩展的像素数
rightExpand	integer	否	向右扩展的像素数
topExpand	integer	否	向上扩展的像素数
bottomExpand	integer	否	向下扩展的像素数
meta	string	否	对扩展区域内容的文字描述，有助于引导 AI 生成

四个方向至少提供一个非零值。

---

请求示例

向右下各扩展 200px：

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"

四方向均匀扩展：

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,
    "meta": "蓝天白云的户外场景"
  }' \
  "https://magiqsight.com/openapi/v1/image/outpainting"

响应示例

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

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