主题
变清晰(Clarify)
对模糊、低质量的图片进行 AI 清晰度增强,提升细节表现与整体清晰度。默认 2.0:按原图尺寸出图,也可指定 1K / 1.5K / 2K。传 engine=v1 则走 1.0,保持原分辨率。
在编辑器中试用:变清晰。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/clarify |
| 所需 Scope | clarify 或 * |
| 任务类型 | 异步,返回 taskId |
| 分辨率 | 2.0 默认 original_pixels(原图尺寸)+ 1k 计费档;也可指定宽高比与 1k / 1.5k / 2k。1.0 保持原图像素 |
请求参数
json
{
"requestId": "可选,调用方自定义唯一 ID",
"url": "原图的公开 HTTPS URL(必填)",
"engine": "可选,v2(默认)或 v1",
"ar": "可选,默认 original_pixels。engine=v1 时忽略",
"outputResolution": "可选,1k / 1.5k / 2k,默认 1k。engine=v1 时忽略"
}参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
requestId | string | 否 | 调用方请求 ID,用于幂等去重 |
url | string | 是 | 模糊图片的公开 HTTPS URL |
engine | string | 否 | v2(默认,可选尺寸)或 v1(保持原分辨率) |
ar | string | 否 | 输出宽高比。缺省 original_pixels(尽量保持原图像素:边长对齐 32,长边小于 512 会放大,大于 4096 会缩小)。也可传 original(按所选分辨率档缩放并保持原图比例),或 1:1、16:9、9:16、4:3、3:4、3:2、2:3 这类 宽:高。engine=v1 时忽略 |
outputResolution | string | 否 | 1k / 1.5k / 2k。缺省 1k。original_pixels 时只影响计费档,不改变画布。engine=v1 时忽略 |
url 须为服务能访问的 HTTPS 地址。本地文件先调用 POST /images/upload,把返回的 data.url 作为 url。
请求示例
bash
curl -s -X POST \
-H "Authorization: Bearer $TUSEN_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/blurry.jpg"
}' \
"https://magiqsight.com/openapi/v1/image/clarify"响应示例
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,尽量保持原图尺寸。需要指定比例或更大画布时传
ar与outputResolution。要 1.0 保原分辨率时传"engine": "v1"。高清放大 用1000/2000/4000三档画幅,或按 2–4 倍放大。
