v1 · 7 个端点 · 已上线
图像编辑
API，为开发者而生
一个 API 密钥背后是七个 AI 图像处理端点：背景移除、图像放大、水印与文字移除、照片修复、上色，以及文本生成图像。纯 REST、JSON 响应，调用结束后不留存任何内容。
- 7 个端点，1 个密钥
- 基于 HTTPS 的 REST
- 无水印
- 不存储任何内容
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}什么是 ImgGen AI 图像编辑 API？
ImgGen AI 图像编辑 API 是一项按需执行 AI 图像处理的 REST 服务。您通过 HTTPS 向某个端点发送一张图像——或一段文本提示词——处理结果会以 base64 编码的形式在 JSON 响应中返回。无需托管模型，也无需配置 GPU。
所有端点共用同一个基础 URL、同一个 API 密钥和相同的响应格式，因此为工作流增加第二项能力只是换一个路径，而不是做一次新的集成。如果您想在写代码之前先试试这些模型，浏览器中的 ImgGen AI 免费工具 用的正是同一批模型。
如何使用图像编辑 API？
生成一个 API 密钥，然后携带您的图像发送一个 multipart 请求。此示例移除背景；其他编辑端点遵循同样的模式，只是路径不同。图像生成是唯一的例外——它接收的是包含提示词、样本数量与宽高比的 JSON 请求体，而不是文件。
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))七个端点
每个端点都有自己的参考页，包含参数、三种语言的代码示例，以及确切的积分费用。
背景移除 API
用一个 POST 请求以编程方式移除图片背景。一个 API 密钥、透明 PNG 输出，以及一个从不保存您所发送图像的无状态服务。
图像放大 API
从您自己的后端把图像分辨率提升 2 倍或 4 倍。可选人脸增强与锐化，输出 JPEG 或 PNG，价格随您所选的放大倍数而变。
水印移除 API
一个请求即可检测并擦除图片中的水印。生成式修补会重建水印下方的像素，而这也是唯一一个还能接受批量图片的端点。
文字移除 API
以编程方式擦除图片中的字幕、叠加文字、时间戳和嵌入标签。检测是自动的——如果图片中没有文字，就不会向您计费。
照片修复 API
从您自己的后端修复老旧、受损与褪色的照片。可在同一个请求中选择上色并提升分辨率，而不必串起三次调用。
照片上色 API
一个请求就能把黑白照片变成色彩自然的图像。可在同一次调用中选择修复撕裂，整个过程无需手动挑选任何颜色。
AI 图像生成 API
用一个 JSON 请求，根据文本提示词生成图像。每次调用最多四个样本，三种模型可在速度与质量之间取舍，输出享有完整商业权利。
图像编辑 API 的费用是多少？
计费基于积分而非按次固定收费，因此繁忙的月份和清闲的月份，单张图片的成本是一样的。积分在所有端点以及网页编辑器之间共用——只有一个余额，而不是每个工具各自一份配额。调用失败会自动退还，每次成功响应都会在 X-Credit-Remaining 响应头中返回您的剩余余额。
| 端点 | 路径 | 积分 / 次调用 |
|---|---|---|
| 背景移除 | /v1/remove-background | 1 |
| 图像放大 | /v1/upscale-image | 2–4 |
| 水印移除 | /v1/remove-watermark | 2 |
| 文字移除 | /v1/remove-text | 2 |
| 照片修复 | /v1/image-restoration | 2 |
| 照片上色 | /v1/colorize-photo | 2 |
| 图像生成 | /v1/generate-image | 3+ |
| 套餐 | 价格 | 积分 | API | 备注 |
|---|---|---|---|---|
| Free | $0 | 50 个一次性免费积分 | 不含 API 访问 | 无需信用卡 |
| Starter | $9.99 / month | 每月 400 积分 | 含 API 访问 | 未使用的积分可滚存 |
| Pro | $29.99 / month | 每月 1,400 积分 | API 访问 + 优先支持 | 未使用的积分可滚存 |
| Enterprise | Custom | 定制用量 | 专属基础设施 | support@imggen.ai |
积分费用与限制最近核实于 2026-08-27. 完整细节见价格页面。
API 如何运作
刻意做得平淡无奇：一个请求，一个响应，您这边不需要任何编排。
同步，无队列
处理后的图像就在同一个响应体中。没有任务 ID 需要轮询、没有 webhook 端点需要搭建、也没有队列需要对账。请求有 60 秒的上限。
multipart 进，base64 出
以 multipart 表单发送您的输入图像——JPEG（JPG）、PNG 和 WebP，最大 25 MB。结果以 base64 编码返回在 JSON 响应体中：解码后写入您存放素材的位置即可。
仅在成功时计费
积分以原子方式扣除，处理失败会自动退还，因此只有真正返回结果的图像才会计费。当没有文字可移除时，文字移除端点甚至会免费返回 422。
可轮换的密钥
密钥只显示一次，且仅以哈希形式存储。吊销大约一分钟内生效，因此密钥泄露只是一分钟的问题，而不是一次事故。
该 API 会存储我的图像或用它们训练吗？
不会。 该 API 是无状态的。与会保存项目以便您回头继续编辑的网页编辑器不同，一次 API 调用不会创建项目、不会写入任务记录，也不会产生任何已存储的文件。您上传的文件会写入一个临时对象，处理完成后在响应返回的同时立即删除。唯一保留的是一条使用日志，记录发生过一次调用以及消耗了多少积分。
您的图像绝不会用于训练模型。如果您处理的是合同约定不得留存的客户照片，这一点尤其重要——把它们挡在我们存储之外的是架构本身，而不仅仅是一纸政策。
错误响应
失败时返回如下形式的 JSON 结构 { "error": { "message", "code" } }，HTTP 状态码与其中的 code 相对应。
| 状态码 | 代码 | 含义 |
|---|---|---|
| 401 | UNAUTHORIZED | API 密钥缺失、格式错误或已被吊销。 |
| 402 | INSUFFICIENT_CREDITS | 您的账户积分不足以完成此次调用。 |
| 403 | FORBIDDEN | 您的套餐不包含此工具的访问权限。 |
| 404 | NOT_FOUND | 该端点路径不存在。 |
| 409 | CONFLICT | 请求与资源当前状态冲突。 |
| 422 | VALIDATION_ERROR | 请求被拒绝——文件类型不受支持、缺少字段，或没有可处理的内容。不会扣除任何积分。 |
谁在使用 ImgGen API？
图像处理 API 在一款产品中真正发挥价值的地方。
电商与电商平台
在上传环节就统一供应商与卖家的图片——抠除背景、去掉叠加文字、放大陈旧的低分辨率老图，让每个商品页看起来都像出自同一个影棚。
按需印刷与产品样机
抠出图案、把分辨率提升到印刷标准，再合成到模板上，无需设计师逐单处理。
设计与编辑类 SaaS
在您自己的产品中提供一键编辑功能，无需托管 GPU、微调模型或维护推理服务。
档案、家谱与数字化
在自动化流水线中修复、上色并放大扫描的照片，而不必逐张手工修图。
内容与出版平台
根据提示词生成原创图像，并在现有编辑流程中清理投稿者上传的素材。
代理机构与内部工具
把客户简报到成品之间那些重复的图像工作自动化，直接在团队已有的工具里完成。
图像编辑 API 常见问题
- 有。ImgGen AI 图像编辑 API 提供七个 REST 端点——背景移除、图像放大、水印移除、文字移除、照片修复、上色，以及文本生成图像——全部位于 https://app.imggen.ai，且都可用同一个 API 密钥访问。
- 它会对您发送的图像执行某项具体编辑，并在同一个响应中返回结果。您可以移除背景得到透明 PNG、放大 2 倍或 4 倍、擦除水印或嵌入的文字、修复并为受损照片上色，以及根据文本提示词生成新图像。
- 在 https://editor.imggen.ai 创建 ImgGen 账户，并在账户设置中生成密钥。密钥只会显示一次且仅以哈希形式存储，请复制到安全的地方：一旦丢失，只能重新生成，无法找回。吊销密钥大约一分钟内生效。
- 每次请求都以 bearer token 形式发送密钥：Authorization: Bearer sk_live_…。在当前方案之前签发的密钥也可使用旧版 x-imggen-key 请求头进行认证，该方式仍然受支持。
- 用量以积分计费而非按次固定收费，费用取决于端点：背景移除 1 积分；水印移除、文字移除、修复与上色为 2 积分；放大在 factor=2 时为 2 积分、factor=4 时为 4 积分；图像生成从 3 积分起，具体随模型而定。Starter 每月 400 积分，9.99 美元；Pro 每月 1,400 积分，29.99 美元，订阅期内未使用的积分可滚存。
- 免费的 ImgGen 账户附带 50 积分且无需信用卡，足够在网页工具中评估这些模型。API 访问本身包含在 Starter 与 Pro 付费套餐中——并不存在长期免费的 API 层级，与其宣传一个之后悄悄限速的版本，我们更愿意把话说清楚。
- 该 API 接受 JPEG（JPG）、PNG 和 WebP 文件，每张图片最大 25 MB。结果以 base64 编码的图像形式在 JSON 响应中返回。
- 同步。没有任务 ID 需要轮询、没有队列需要管理、也没有 webhook 需要配置——处理后的图像就在同一个响应体中。请求有 60 秒的上限。
- 不会。该 API 是无状态的：它不会创建项目、不会保存文件，也不会保留您的图像。您上传的文件会写入一个临时对象，处理完成后在响应返回的同时立即删除。唯一保留的是一条使用日志，记录发生过一次调用以及消耗了多少积分。您的图像绝不会用于训练模型。
- 可以。包括免费套餐在内的所有套餐都包含完整的商业使用权，且任何输出都不带水印。API 返回的任何内容，您都可以出售、打印或发布。
- 水印移除端点接受以 image[] 提交的一批文件，并返回 images 数组。其余所有端点每次请求处理一张图像——若需要吞吐量，请从您自己的 worker 并发发送请求，因为每次调用都是独立的。
- 目前没有。该 API 是基于 HTTPS 的纯 REST，配合 multipart 上传，因此任何 HTTP 客户端都能使用，文档中也提供了可直接复制的 cURL、Node.js 与 Python 示例。目前还没有官方客户端库，也没有公开的 OpenAPI 规范。