Skip to content

变清晰(Clarify) ​

对模糊、低质量的图片进行 AI 清晰度增强,提升细节表现与整体清晰度。默认 2.0:按原图尺寸出图,也可指定 1K / 1.5K / 2K。传 engine=v1 则走 1.0,保持原分辨率。

在编辑器中试用:变清晰。

基本信息 ​

项目值
接口路径POST /image/clarify
所需 Scopeclarify 或 *
任务类型异步,返回 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 时忽略"
}

参数说明 ​

参数类型必填说明
requestIdstring否调用方请求 ID,用于幂等去重
urlstring是模糊图片的公开 HTTPS URL
enginestring否v2(默认,可选尺寸)或 v1(保持原分辨率)
arstring否输出宽高比。缺省 original_pixels(尽量保持原图像素:边长对齐 32,长边小于 512 会放大,大于 4096 会缩小)。也可传 original(按所选分辨率档缩放并保持原图比例),或 1:1、16:9、9:16、4:3、3:4、3:2、2:3 这类 宽:高。engine=v1 时忽略
outputResolutionstring否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 倍放大。

妙图设计 API Beta