2 积分 每次调用

照片修复 API

从您自己的后端修复老旧、受损与褪色的照片。可在同一个请求中选择上色并提升分辨率,而不必串起三次调用。

  • REST · JSON
  • 无水印
  • 不存储任何内容
endpoint

POST /v1/image-restoration

基础 URL
https://app.imggen.ai
认证
Authorization: Bearer sk_live_…
费用
2 积分
输入
JPEG (JPG), PNG and WebP · max 25 MB

01 — 概览

什么是照片修复 API?

ImgGen AI 照片修复 API 是一个 REST 端点,用于修复受损照片。它可减轻划痕、撕裂、污渍、褪色与模糊,并可在同一次调用中为黑白原片上色、提升其分辨率。您上传扫描件,修复后的图像会在响应中返回。

这是 ImgGen AI 图像编辑 API 七个端点之一,它们共用同一个 API 密钥、同一个基础 URL,以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能,同一套 AI 模型也驱动着 Image Restoration 工具。

02 — 请求

请求参数

https://app.imggen.ai/v1/image-restoration 发送一个 POST 请求,并在 Authorization 请求头中使用 API 密钥进行认证。

此端点接受的参数
参数类型必填默认值说明
imagefile必填在修复的同时为黑白照片添加逼真的色彩。
colorizeboolean可选false修复划痕、撕裂与物理损伤。
removeTearsboolean可选false放大修复后的图像以获得更高分辨率。会在本次调用上追加放大器的费用。
enhanceResolutionboolean可选falseUpscale the restored image for extra resolution. Adds the upscaler cost to the call.
03 — 集成

如何集成照片修复 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=false
04 — 响应

响应

成功的调用会返回 JSON。结果为 base64 编码——写入磁盘或对象存储前请先解码。每次成功的响应还会带上 X-Credit-Remaining 请求头,显示本次调用后的余额。

{
  "success": true,
  "message": "Image restored successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}
05 — 限制

值得了解的限制与行为

该端点接受 JPEG(JPG)、PNG 和 WebP,文件最大 25 MB,并在 60 秒内同步返回结果——无需轮询任务,也无需配置 webhook。

三项操作,一次调用

修复、上色和放大是同一个请求上的开关,而不是彼此独立的端点,因此一次完整修复只需一个往返,而不是三个。

enhanceResolution 需额外付费

开启 enhanceResolution 会在基础修复费用之上追加放大器的费用,因为它还会运行放大模型。

扫描质量很重要

模型是根据它能看到的内容进行重建的。用扫描仪支持的最高分辨率、平整且光照均匀地扫描,效果会明显优于用手机翻拍纸质照片。

06 — 生产实践

照片修复 API 用在哪些场景?

各团队将此端点用于生产环境,以编程方式大规模处理图像的场景。

家谱与档案平台

为用户上传的家庭照片提供一键修复,而无需自行构建或托管修复模型。

数字化服务

在扫描件产出的同时自动运行修复,让操作人员只需复核结果,而不是逐张编辑。

博物馆与图书馆藏品

为劣化的照片资料制作可供展示的利用副本,同时保持原件不受触碰。

照片冲印产品

在送印之前,用一次调用修复并放大客户上传的照片。

07 — 费用

照片修复 API 的费用是多少?

每次成功调用消耗 2 积分,因此单张图片的实际成本取决于您所用的套餐。积分来自您的套餐,并在所有端点与网页编辑器之间共用,您无需为每个工具单独购买配额。调用失败会自动退还。完整细节见价格页面

ImgGen AI 套餐与 API 访问
套餐价格积分API
Free$050 个一次性免费积分不含 API 访问
Starter$9.99 / month每月 400 积分含 API 访问
Pro$29.99 / month每月 1,400 积分API 访问 + 优先支持
EnterpriseCustom定制用量专属基础设施

积分费用与限制最近核实于 2026-08-27.

08 — 相关

使用照片修复 API 的团队,接下来通常还会用到这些。

照片上色 API图像放大 APIImage Restoration (网页工具)全部 API 端点

另可使用: 背景移除, 水印移除, 文字移除, 图像生成.

FAQ

照片修复 API 常见问题

它是一个 HTTP 端点,可自动修复受损照片。它能减轻划痕、撕裂、污渍、褪色与模糊,并可选择为结果上色和放大。它的存在,是为了让一款产品无需任何人手工修图,就能向用户提供照片修复能力。

开始使用

开始调用照片修复 API

一个密钥即可解锁全部七个端点。无水印、完整商业权利,且您发送的任何内容在响应返回后都不会被保留。

获取 API 密钥