高清放大（Super Resolution）

将低分辨率图像放大为高清图像，同时还原细节、增强清晰度。

基本信息

项目	值
接口路径	POST /image/super-resolution
所需 Scope	super_resolution（规范名）或别名 super-res、super_res，或 *

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

---

请求参数

{
  "requestId": "可选，调用方自定义唯一 ID",
  "url": "图像公开 HTTPS URL（必填）",
  "upScale": 2,
  "targetResolution": null
}

参数说明

参数	类型	必填	默认值	说明
requestId	string	否	null	调用方请求 ID
url	string	是	—	待放大图像的公开 HTTPS URL
upScale	integer	否	2	放大倍数（2 ~ 4）。targetResolution 未设置时生效
targetResolution	integer	否	null	目标长边像素数，可选值：1000、2000、4000。设置后优先于 upScale

二选一：upScale 与 targetResolution 二选一。若两者都提供，targetResolution 优先生效。

---

请求示例

按倍数放大（2 倍）：

curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/low-res-photo.jpg",
    "upScale": 2
  }' \
  "https://magiqsight.com/openapi/v1/image/super-resolution"

按目标分辨率放大（长边 2000px）：

curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/low-res-photo.jpg",
    "targetResolution": 2000
  }' \
  "https://magiqsight.com/openapi/v1/image/super-resolution"

---

响应示例

提交成功：

{
  "code": 0,
  "msg": null,
  "data": {
    "requestId": null,
    "taskId": "img-superres654mn"
  }
}

---

获取结果

任务成功（status: 1）后，imageUrls 包含高清放大后的图像。

详见异步任务文档。

---

常见问题

Q：upScale 和 targetResolution 有什么区别？
A：upScale 是相对倍数（2-4 倍，如原图 500px 宽，upScale=2 则输出约 1000px 宽）；targetResolution 是绝对像素值（1000/2000/4000，长边精确到指定像素数），适合有固定输出尺寸要求的场景。

Q：两个参数必须二选一吗？
A：是的。必须提供 upScale 或 targetResolution 之一，但不能同时提供。如果两者都提供，会返回错误。

Q：放大后文件会很大吗？
A：是的，高清放大会显著增大文件体积。建议通过 imagePreviewUrls 先预览效果，再使用 imageUrls 获取完整高清版本。

Q：对输入图像的分辨率有要求吗？
A：输入图像过小（如极低分辨率）可能影响放大质量，建议输入图像长边不低于 100px。