主题
高清放大(Super Resolution)
将低分辨率图像放大为高清图像,同时还原细节、增强清晰度。
在编辑器中试用:高清放大。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/super-resolution |
| 所需 Scope | super_resolution(规范名)或别名 super-res、super_res,或 * |
| 任务类型 | 异步,返回 taskId |
请求参数
json
{
"requestId": "可选,调用方自定义唯一 ID",
"url": "图像公开 HTTPS URL(必填)",
"upScale": 2,
"targetResolution": null
}参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
requestId | string | 否 | 服务端生成 | 调用方请求 ID。省略时由服务端生成并在响应里返回 |
url | string | 是 | — | 待放大图像的公开 HTTPS URL |
upScale | integer | 否 | 2 | 放大倍数(2 ~ 4)。按原图像素相乘。乘完后若宽超过 3840 或高超过 2160,倍数会减小以放进 3840×2160,但不会把已经更大的图缩小。targetResolution 为 1000 / 2000 / 4000 时不使用本字段 |
targetResolution | integer | 否 | null | 只接受 1000、2000、4000,分别对应画幅 1920×1080、2560×1440、3840×2160。按能放进该画幅的比例放大(取宽、高缩放比中较小的一个),已大于该画幅时不缩小。设置后优先于 upScale |
url 须为服务能访问的 HTTPS 地址。本地文件先调用 POST /images/upload,把返回的 data.url 作为 url。
可以只传
url,此时按upScale=2。targetResolution传了1000、2000或4000时按上表画幅,不再用upScale。其他数字不会按画幅处理,退回upScale(未传则为 2)。
请求示例
按倍数放大(2 倍):
bash
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"按画幅放大(targetResolution=2000,2560×1440):
bash
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"响应示例
提交成功:
json
{
"code": 0,
"msg": "",
"data": {
"requestId": "req_abc123",
"taskId": "img-superres654mn"
}
}获取结果
任务成功(status: 1)后,resultType 为 image,高清图在 imageUrls,预览在 imagePreviewUrls。任务失败(status: 2)时查看 resultMetadata。
详见异步任务文档。
常见问题
Q:upScale 和 targetResolution 有什么区别?
A:upScale 是相对倍数(2–4)。原图不大时,500px 宽、upScale=2 大约得到 1000px 宽。乘完超过 3840×2160 时倍数会减小,但不会把已经更大的图缩小。targetResolution 不是长边像素:1000 对应 1920×1080,2000 对应 2560×1440,4000 对应 3840×2160,按能放进该画幅的比例放大,已经更大的图不缩小。
Q:两个参数必须二选一吗?
A:不用。都不传时 upScale 默认为 2。targetResolution 为 1000、2000 或 4000 时优先按画幅,忽略 upScale。
Q:放大后文件会很大吗?
A:是的,高清放大会显著增大文件体积。建议通过 imagePreviewUrls 先预览效果,再使用 imageUrls 获取完整高清版本。
