AI 图片变清晰 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 次免费体验，超出按点数扣费（详见控制台）。
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. 请求示例
以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。
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"
}'Python
import requests
resp = requests.request(
"POST",
"https://v1.apizero.cn/api/image-enhance",
headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
json={
"img": "https://example.com/blurry-photo.jpg",
},
timeout=15,
)
resp.raise_for_status()
print(resp.json())JavaScript (Node.js)
// Node.js 18+ / 浏览器原生 fetch
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": "https://example.com/blurry-photo.jpg"
}),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);Go
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
body := []byte(`{"img":"https://example.com/blurry-photo.jpg"}`)
req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/image-enhance", bytes.NewBuffer(body))
req.Header.Set("X-Api-Key", "YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))
}PHP
<?php
$payload = json_encode([
"img" => "https://example.com/blurry-photo.jpg",
], JSON_UNESCAPED_UNICODE);
$ch = curl_init("https://v1.apizero.cn/api/image-enhance");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $payload,
CURLOPT_HTTPHEADER => [
"X-Api-Key: YOUR_API_KEY",
"Content-Type: application/json",
],
CURLOPT_TIMEOUT => 15,
]);
$body = curl_exec($ch);
curl_close($ch);
$data = json_decode($body, true);
print_r($data);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
常见问题
AI 图片变清晰 接口怎么免费使用？
未登录用户每个 IP 每天 0 次免费。登录用户创建 API Key 后每天 10 次免费，超额部分按点数计费（0 点/次）。
AI 图片变清晰 支持哪些调用方式？
接口使用 POST 请求。文档提供 cURL、Python、JavaScript (Node.js)、Go、PHP 五种语言的可运行示例。也可以下载 /openapi.json 导入 Postman / Insomnia / Apifox 反向生成 SDK。
调用不限额么？ QPS 是多少？
本接口 QPS 限制 1 req/s，每个 API Key 每日免费 10 次。需要更高额度可升级 VIP 套餐或联系售后提高 QPS。
这个接口跟自己直连上游有什么区别？
极数本源 作为中间层提供：统一鉴权（一个 Key 调所有接口）、统一计费（点数制）、统一限流、统一错误码、多上游自动切换。免去逐个对接上游、维护 Key、统计调用量的运维成本。