做内容系统、电商后台、素材工具或头像处理功能时，经常会遇到同一个问题：用户上传或提交的图片尺寸太小，放到详情页、封面图、预览卡片里会显得模糊。自己从零搭一套图片高清化流程，需要处理模型服务、图片下载、格式识别、任务等待和结果回传，链路会比较长。

极数本源的 image-enhance 接口把这件事封装成了一个标准 POST API。开发时传入一张公网可访问的图片 URL，接口会返回增强后的高清图片地址，并给出增强后的宽高信息。它适合用在商品图优化、老照片修复、低清截图增强、设计素材放大、社交头像高清化等场景。

官方页面：https://apizero.cn/marketplace/image-enhance

接口适合解决什么问题

我通常会把图片增强需求分成两类：一类是“图片本身内容可用，但分辨率不够”；另一类是“图片能看清大概内容，但噪点、糊边、缩放痕迹比较明显”。image-enhance 的价值就在于把这两类问题收敛成一个接口调用。

它的核心能力包括：

• 对低分辨率图片做约 4 倍超分辨率增强
• 自动处理去噪、去糊和细节锐化
• 保留原图色彩和构图
• 返回可直接展示或下载的增强图 URL
• 返回增强后的图片宽度和高度，方便前端布局

这类能力很适合放在已有业务流程里做“图片质量提升”这一层，而不是让业务系统直接接触复杂的图像模型任务。

基本接入信息

接口地址：

POST https://v1.apizero.cn/api/image-enhance

请求参数：

参数	类型	必填	说明
img	string	是	待增强的图片 URL，使用公网可访问的 http/https 地址

请求头：

Header	说明
X-Api-Key	API Key 鉴权，可在控制台申请
Content-Type	可使用 application/json 或 application/x-www-form-urlencoded

最小请求示例：

curl -X POST "https://v1.apizero.cn/api/image-enhance" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "img": "https://example.com/blurry-photo.jpg"
  }'

如果你的项目里统一使用表单提交，也可以传 form-urlencoded：

curl -X POST "https://v1.apizero.cn/api/image-enhance" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "img=https://example.com/blurry-photo.jpg"

场景一：电商商品图高清化

电商系统里经常会遇到历史商品图尺寸偏小的问题。比如老数据里的图片只有 300×300，放到详情页、推荐位或营销活动页时，视觉效果不够稳定。

在这种场景里，可以把图片增强放到商品素材处理流程中：

1. 后台读取商品原图 URL
2. 调用 image-enhance 获取增强图
3. 记录增强后的 enhanced_url、width、height
4. 前端优先展示增强图，并根据返回宽高做布局

这样业务侧不用自己关心图片增强任务的内部过程，只需要保存接口返回的高清结果。

场景二：自媒体配图和截图修复

自媒体内容里经常会用到旧照片、历史截图、聊天记录截图、封面素材等图片。它们的共同特点是来源分散，尺寸和清晰度不统一。

如果把图片增强接到内容发布后台，编辑人员只需要提交原图链接，系统就可以生成一张更适合展示的高清版本。对于封面、图文配图、资料卡图片，这种流程能减少手工处理时间，也能让发布出来的内容更统一。

场景三：设计素材快速放大

设计或运营系统里，常见情况是素材内容合适，但尺寸不够。比如图标、头像、插画局部、活动素材预览图，需要快速放大后再进入下一步处理。

image-enhance 返回的是增强后的图片 URL，适合接入到素材库、设计工具、内部运营后台里。前端可以在增强完成后直接展示新图，后端也可以把结果保存到自己的素材管理系统中。

返回字段怎么看

接口成功返回后，重点看 data 里的字段：

字段	类型	说明
original_url	string	原始图片 URL 回显
enhanced_url	string	增强后的图片 URL
width	integer	增强后图片宽度
height	integer	增强后图片高度
expires_in	integer	结果 URL 的有效时间，单位为秒

返回示例：

{
  "code": 0,
  "msg": "成功",
  "data": {
    "original_url": "https://example.com/blurry-photo.jpg",
    "enhanced_url": "https://v1.apizero.cn/api/image-enhance?mode=image&u=aHR0cHM6Ly9...&s=a1b2c3d4e5f6",
    "width": 1200,
    "height": 1200,
    "expires_in": 21600
  },
  "request_id": "mqx8x12345abc"
}

前端展示时通常直接使用：

data.enhanced_url

如果要做图片预览容器，可以同时使用：

data.width
data.height

Python 封装示例

在后端服务里，我会把它封装成一个函数，让业务层只关心“输入原图，拿到增强图”：

import requests


def enhance_image(img_url: str) -> dict:
    resp = requests.post(
        "https://v1.apizero.cn/api/image-enhance",
        headers={
            "X-Api-Key": "YOUR_API_KEY",
            "Content-Type": "application/json",
        },
        json={
            "img": img_url,
        },
        timeout=40,
    )
    payload = resp.json()
    return payload["data"]


result = enhance_image("https://example.com/blurry-photo.jpg")

print("原图:", result["original_url"])
print("高清图:", result["enhanced_url"])
print("尺寸:", result["width"], result["height"])

业务系统可以把 enhanced_url 保存到商品表、素材表或内容资源表里，前端展示时直接读取这个字段。

JavaScript 调用示例

如果是 Node.js 服务端，可以这样封装：

async function enhanceImage(imgUrl) {
  const res = await fetch("https://v1.apizero.cn/api/image-enhance", {
    method: "POST",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      img: imgUrl,
    }),
  });

  const json = await res.json();
  return json.data;
}

const enhanced = await enhanceImage("https://example.com/blurry-photo.jpg");

console.log(enhanced.enhanced_url);
console.log(`${enhanced.width}x${enhanced.height}`);

前端页面拿到增强结果后，可以直接渲染：

<img id="preview" alt="enhanced image" />

<script>
  function renderEnhancedImage(data) {
    const preview = document.querySelector("#preview");
    preview.src = data.enhanced_url;
    preview.width = Math.min(data.width, 600);
  }
</script>

对于生产项目，更推荐由服务端统一调用接口，再把增强结果返回给前端。这样鉴权信息、素材入库和结果管理都会更清晰。

接入到业务流程里

一个比较自然的接入方式是：

1. 用户或运营人员提交图片 URL
2. 后端校验并调用 image-enhance
3. 记录增强图 URL 和尺寸
4. 前端展示增强前后效果
5. 内容发布、商品更新或素材入库时使用增强图

如果系统里已经有图片上传、图片审核或素材管理模块，这个接口可以作为其中的“高清化处理”步骤。对业务代码来说，它只是一次 POST 请求；对展示效果来说，图片质量会更适合放到详情页、封面和预览卡片中。