AI 图片变清晰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 次免费体验，超出按点数扣费（详见控制台）。

1. 基本信息

接口地址	`https://v1.apizero.cn/api/image-enhance`
请求方法	`POST`
分类	ai
提供方	极数本源
计费模式	免费试用
单次消耗	0 积分
起步价	—
QPS 限制	1 req/s
每日免费额度	10 次（已认证用户）
匿名每日额度	0 次（无 API Key）
VIP 免费	否
调用次数

2. 认证

需要 API Key（Bearer Token）。登录用户每日 10 次免费额度；本接口为重型计算，未登录禁用。

获取 API Key：登录 https://apizero.cn/account/keys

3. 请求参数

参数名	类型	必填	说明	示例
`img`	`string`	是	待增强的图片 URL，必须是公网可访问的 http/https 地址；文件 ≤ 10 MB；JPEG / PNG / WebP / BMP 格式	`https://example.com/blurry-photo.jpg`

4. 请求头

Header	类型	必填	说明	示例
`Authorization`	`string`	是	API Key 鉴权（在控制台申请）	—
`Content-Type`	`string`	否	使用 form-urlencoded 或 JSON body 都可	—

5. 请求示例 (cURL)

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"
}'

6. 响应字段

字段	类型	说明	示例
`code`	`integer`	业务状态码，0 表示成功	`0`
`msg`	`string`	人类可读的状态消息	`成功`
`data.original_url`	`string`	回显的原图 URL（即用户提交的 img 参数）	`https://example.com/blurry-photo.jpg`
`data.enhanced_url`	`string`	增强后的图片 URL（平台代理，6 小时内有效）	`https://v1.apizero.cn/api/image-enhance?mode=image&u=...&s=...`
`data.width`	`integer`	增强后图片宽度（像素，通常约为原图 4 倍）	`1200`
`data.height`	`integer`	增强后图片高度（像素，通常约为原图 4 倍）	`1200`
`data.expires_in`	`integer`	enhanced_url 有效期（秒），固定 21600 = 6 小时	`21600`
`request_id`	`string`	本次请求 ID	`mqx8x12345abc`

7. 响应示例

{
    "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"
}

8. 错误码

code	status	说明
`0`	`OK`	成功
`4000`	`Bad Request`	参数错误：缺少 img 参数 / URL 格式不合法 / 文件过大（>10MB）/ 不支持的图片格式
`4011`	`Unauthorized`	API Key 无效
`4013`	`Forbidden`	API Key 已暂停
`4014`	`Forbidden`	当前 IP 不在 API Key 白名单内
`4015`	`Unauthorized`	本接口需要 API Key 才能调用（不开放匿名）
`4022`	`Payment Required`	余额不足，请充值后再试
`4029`	`Too Many Requests`	调用过快（QPS 限制 1 次/秒）
`4030`	`Too Many Requests`	今日免费额度已用完（登录用户每日 10 张）
`5020`	`Bad Gateway`	图片增强服务暂不可用：上游超时 / 上传失败 / 任务创建失败
`5021`	`Bad Gateway`	上游返回数据异常

9. 变更日志

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