AI 图片变清晰

image-enhancePOST
POSThttps://v1.apizero.cn/api/image-enhance

概述

基于先进 AI 超分辨率算法的图片高清化服务。输入一张模糊 / 低分辨率图片 URL,约 4 秒内返回 4 倍超分辨率的高清版本(如 300×300 → 1200×1200),支持 JPEG / PNG / WebP / BMP 等主流格式。 【核心能力】 - 4 倍超分辨率(最大边自动放大约 4 倍) - 自动去噪 / 去糊 / 锐化细节 - 保留原图色彩与构图 - 适合老照片修复、缩略图放大、低质截图增强、网络图片优化 - 输出 JPEG 高质量(HD 模式) 【典型场景】 - 电商:商品低清图自动高清化 - 自媒体:老照片 / 截图修复用于配图 - 设计:素材尺寸不够时快速放大 - 视频缩略图、社交头像高清化 - 旧扫描件 / 截屏文字增强 【调用示例】 POST /api/image-enhance Content-Type: application/x-www-form-urlencoded img=https://example.com/your-blurry-image.jpg 【⚠️ 输入限制】 - 必须是 **公网可访问** 的 http/https URL(私有 OSS 链接需先签名) - 文件大小 ≤ 10 MB - 支持格式:JPEG / PNG / WebP / BMP 【⚠️ 输出说明】 - 返回的 enhanced_url 为平台代理 URL(自有域名,跨域友好) - 实际图片在 6 小时内有效,请尽快下载保存 - 平均响应 4~6 秒,复杂图片可能需要 10~30 秒 【计费说明】 登录用户每日 10 次免费体验,超出按点数扣费(详见控制台)。

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/image-enhance/raw.md
打开 Markdown

鉴权

需要 API Key(Bearer Token)。登录用户每日 10 次免费额度;本接口为重型计算,未登录禁用。

获取 API Key

请求头

Authorizationstring选填

推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。匿名可不传,受每日免费额度限制。

Content-Typestring选填

使用 form-urlencoded 或 JSON body 都可

请求参数

POST · APPLICATION/JSON

imgstring必填

待增强的图片 URL,必须是公网可访问的 http/https 地址;文件 ≤ 10 MB;JPEG / PNG / WebP / BMP 格式

例https://example.com/blurry-photo.jpg

{
  "img": "https://example.com/blurry-photo.jpg"
}

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

codeinteger

业务状态码,0 表示成功

msgstring

人类可读的状态消息

data.original_urlstring

回显的原图 URL(即用户提交的 img 参数)

data.enhanced_urlstring

增强后的图片 URL(平台代理,6 小时内有效)

data.widthinteger

增强后图片宽度(像素,通常约为原图 4 倍)

data.heightinteger

增强后图片高度(像素,通常约为原图 4 倍)

data.expires_ininteger

enhanced_url 有效期(秒),固定 21600 = 6 小时

request_idstring

本次请求 ID

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

返回示例

{
  "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",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

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

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快(QPS)

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
完全免费
QPS 限制
QPS 1
登录免费额度
10 次(已认证)
匿名每日额度
无
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.0.02026-05-05

    首次发布 支持 4 倍超分辨率高清化 支持 JPEG / PNG / WebP / BMP 主流格式 平均 4 秒响应 支持文件 ≤ 10 MB

AI 图片变清晰 接入文档|极数本源