什么是照片修复 API?
ImgGen AI 照片修复 API 是一个 REST 端点,用于修复受损照片。它可减轻划痕、撕裂、污渍、褪色与模糊,并可在同一次调用中为黑白原片上色、提升其分辨率。您上传扫描件,修复后的图像会在响应中返回。
这是 ImgGen AI 图像编辑 API 七个端点之一,它们共用同一个 API 密钥、同一个基础 URL,以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能,同一套 AI 模型也驱动着 Image Restoration 工具。
请求参数
向 https://app.imggen.ai/v1/image-restoration 发送一个 POST 请求,并在 Authorization 请求头中使用 API 密钥进行认证。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| image | file | 必填 | — | 在修复的同时为黑白照片添加逼真的色彩。 |
| colorize | boolean | 可选 | false | 修复划痕、撕裂与物理损伤。 |
| removeTears | boolean | 可选 | false | 放大修复后的图像以获得更高分辨率。会在本次调用上追加放大器的费用。 |
| enhanceResolution | boolean | 可选 | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
如何集成照片修复 API?
在您的 ImgGen 账户中创建一个 API 密钥,将其设为环境变量,然后调用该端点。以下是同一个请求的 cURL、Node.js 与 Python 写法。
curl --request POST \
--url 'https://app.imggen.ai/v1/image-restoration' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form colorize=false \
--form removeTears=true \
--form enhanceResolution=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('colorize', 'false');
form.append('removeTears', 'true');
form.append('enhanceResolution', 'false');
const res = await fetch('https://app.imggen.ai/v1/image-restoration', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/image-restoration",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"colorize": "false", "removeTears": "true", "enhanceResolution": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))响应
成功的调用会返回 JSON。结果为 base64 编码——写入磁盘或对象存储前请先解码。每次成功的响应还会带上 X-Credit-Remaining 请求头,显示本次调用后的余额。
{
"success": true,
"message": "Image restored successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}值得了解的限制与行为
该端点接受 JPEG(JPG)、PNG 和 WebP,文件最大 25 MB,并在 60 秒内同步返回结果——无需轮询任务,也无需配置 webhook。
三项操作,一次调用
修复、上色和放大是同一个请求上的开关,而不是彼此独立的端点,因此一次完整修复只需一个往返,而不是三个。
enhanceResolution 需额外付费
开启 enhanceResolution 会在基础修复费用之上追加放大器的费用,因为它还会运行放大模型。
扫描质量很重要
模型是根据它能看到的内容进行重建的。用扫描仪支持的最高分辨率、平整且光照均匀地扫描,效果会明显优于用手机翻拍纸质照片。
照片修复 API 用在哪些场景?
各团队将此端点用于生产环境,以编程方式大规模处理图像的场景。
家谱与档案平台
为用户上传的家庭照片提供一键修复,而无需自行构建或托管修复模型。
数字化服务
在扫描件产出的同时自动运行修复,让操作人员只需复核结果,而不是逐张编辑。
博物馆与图书馆藏品
为劣化的照片资料制作可供展示的利用副本,同时保持原件不受触碰。
照片冲印产品
在送印之前,用一次调用修复并放大客户上传的照片。
照片修复 API 的费用是多少?
每次成功调用消耗 2 积分,因此单张图片的实际成本取决于您所用的套餐。积分来自您的套餐,并在所有端点与网页编辑器之间共用,您无需为每个工具单独购买配额。调用失败会自动退还。完整细节见价格页面。
| 套餐 | 价格 | 积分 | API |
|---|---|---|---|
| Free | $0 | 50 个一次性免费积分 | 不含 API 访问 |
| Starter | $9.99 / month | 每月 400 积分 | 含 API 访问 |
| Pro | $29.99 / month | 每月 1,400 积分 | API 访问 + 优先支持 |
| Enterprise | Custom | 定制用量 | 专属基础设施 |
积分费用与限制最近核实于 2026-08-27.
相关端点与工具
使用照片修复 API 的团队,接下来通常还会用到这些。
照片修复 API 常见问题
- 它是一个 HTTP 端点,可自动修复受损照片。它能减轻划痕、撕裂、污渍、褪色与模糊,并可选择为结果上色和放大。它的存在,是为了让一款产品无需任何人手工修图,就能向用户提供照片修复能力。
- 可以。设置 colorize=true,模型会在同一次修复过程中加入逼真的色彩。如果您只需要上色、照片本身并未受损,专门的上色端点更便宜也更直接。
- 每次成功调用 2 积分。设置 enhanceResolution=true 会在此之上追加放大器的费用,因为会运行第二个模型。Starter 每月 400 积分、9.99 美元,Pro 每月 1,400 积分、29.99 美元,订阅期间未使用的积分可滚存。
- 划痕、撕裂、污渍、水渍、褪色、发黄以及整体发虚。针对物理损伤请设置 removeTears=true。原始画面内容已完全缺失的区域是被合理地重建出来的,而不是被还原——模型是在推测,而不是在撤销。
- 有可能,把它交到用户手上之前值得了解这一点。模型通过推断来重建缺失信息,因此一张严重受损或分辨率极低的人脸,返回时可能与原片中的人略有出入。它依据可见的内容工作;在完全不可见之处,它给出的是合理的猜测。请把输出视为一次修复后的诠释,而不是被还原的原件。
- 每次请求一张照片。该端点没有批量形式——只有水印移除支持 image[]。若要处理整个档案,请从您自己的 worker 并发发送请求;每次请求都是独立的,也各自计费。
- 该 API 接受 JPEG(JPG)、PNG 和 WebP 文件,每张图片最大 25 MB。结果以 base64 编码的图像形式在 JSON 响应中返回。
- 不会。该 API 是无状态的:它不会创建项目、不会保存文件,也不会保留您的图像。您上传的文件会写入一个临时对象,处理完成后在响应返回的同时立即删除。唯一保留的是一条使用日志,记录发生过一次调用以及消耗了多少积分。您的图像绝不会用于训练模型。
- 可以。包括免费套餐在内的所有套餐都包含完整的商业使用权,且任何输出都不带水印。API 返回的任何内容,您都可以出售、打印或发布。