智能修图（Smart Edit）

根据自然语言提示词对图片进行 AI 编辑，支持替换背景、修改元素、调整氛围等多种操作。

基本信息

项目	值
接口路径	POST /image/smart-edit
所需 Scope	smart_edit 或 *

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

---

请求参数

{
  "requestId": "可选，调用方自定义唯一 ID",
  "url": "单张图片 URL（与 urls 二选一）",
  "urls": ["多张参考图 URL（与 url 二选一）"],
  "prompt": "编辑提示词（必填）",
  "ar": "1:1",
  "count": 1,
  "imageModel": "base_v2"
}

参数说明

参数	类型	必填	默认值	说明
requestId	string	否	null	调用方请求 ID，用于幂等去重
url	string	否	—	单张图片 URL，与 urls 二选一
urls	string[]	否	—	多张参考图 URL 列表，与 url 二选一
prompt	string	是	—	描述期望修图效果的自然语言提示词
ar	string	否	—	输出宽高比，如 1:1、4:3、16:9
seed	integer	否	null	随机种子（≥0），相同 seed 生成结果更稳定
count	integer	否	1	生成图像数量（1 ~ 4）
imageModel	string	否	base_v2	图像模型，可选：base_v1、base_v2、text_enhance_v1、text_enhance_v2

url 与 urls 至少提供其一。

---

请求示例

替换背景：

curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "prompt": "将背景替换为海边日落"
  }' \
  "https://magiqsight.com/openapi/v1/image/smart-edit"

使用增强模型生成多张：

curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "prompt": "增加梦幻光晕效果",
    "imageModel": "text_enhance_v1",
    "count": 2
  }' \
  "https://magiqsight.com/openapi/v1/image/smart-edit"

响应示例

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

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