<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# AI 图片变清晰

> 基于先进 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. 基本信息

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

## 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)

```bash
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. 响应示例

```json
{
    "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

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/image-enhance`

Source: `https://apizero.cn/aidocs/image-enhance/raw.md`
Last updated: 2026-05-11T16:16:07+08:00