什么是水印移除 API？
ImgGen AI 水印移除 API 是一个 REST 端点，它会找到图片中的水印并重建其下方的内容。检测是自动的，因此无需蒙版，生成式修补会把清除后的区域填充得与周围一致，而不是简单模糊。清理后的图片会在同一个响应中返回。
这是 ImgGen AI 图像编辑 API 七个端点之一，它们共用同一个 API 密钥、同一个基础 URL，以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能，同一套 AI 模型也驱动着 Watermark Remover 工具。
请求参数
向 https://app.imggen.ai/v1/remove-watermark 发送一个 POST 请求，并在 Authorization 请求头中使用 API 密钥进行认证。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| image | file | 必填 | — | 批量形式。用 image[] 提交多个文件即可在一次请求中处理；响应会返回 images 数组，以及包含未能处理项的 failedImages。 |
| image[] | file[] | 可选 | — | Batch form. Send multiple files under image[] to process them in one request; the response returns an images array plus failedImages for any that could not be processed. |
如何集成水印移除 API？
在您的 ImgGen 账户中创建一个 API 密钥，将其设为环境变量，然后调用该端点。以下是同一个请求的 cURL、Node.js 与 Python 写法。
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-watermark' \
--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-watermark', {
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/remove-watermark",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))响应
成功的调用会返回 JSON。结果为 base64 编码——写入磁盘或对象存储前请先解码。每次成功的响应还会带上 X-Credit-Remaining 请求头，显示本次调用后的余额。
{
"success": true,
"message": "Watermark removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}值得了解的限制与行为
该端点接受 JPEG（JPG）、PNG 和 WebP，文件最大 25 MB，并在 60 秒内同步返回结果——无需轮询任务，也无需配置 webhook。
批量上传
这是 ImgGen 唯一接受批量的端点。用 image[] 提交多个文件，响应中会带有 images 数组，并在 failedImages 中列出所有未能处理的项。
自动检测
没有蒙版、选框或画笔参数。模型会自行定位水印，因此同一种请求形式可以应对差异很大的源图。
只编辑属于您的内容
从不属于您、或您没有编辑授权的图片上移除水印，可能构成侵权。请在您自己的素材，或您有权修改的图片上使用此端点。
水印移除 API 用在哪些场景？
各团队将此端点用于生产环境，以编程方式大规模处理图像的场景。
取回自己的图库
在品牌形象更换时，从成千上万张自有图片中去掉旧的影棚水印，无需手工重新处理原图。
授权素材工作流
在向 CMS 发布的自动化流程中，清理您已获授权、带预览标记的素材。
摄影交付
客户付款后，直接由订单系统驱动，去掉图片上的样片标记。
模板制作
在把自有源素材合成进模板或样机之前，先清除其上叠加的标记。
水印移除 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 端点，接收一张带水印的图片，返回同一张图片——水印已被移除，其下方区域已被重建。因为检测是自动的，您不必告诉它水印在哪里——而这正是它能用于无人值守批处理的原因。
- 可以。水印移除是 ImgGen 唯一支持批量的端点：用 image[] 而不是 image 提交文件，响应会返回 images 数组，以及包含未能处理项的 failedImages 数组。其余所有端点每次请求处理一张图片。
- 每张成功处理的图片 2 积分，批量中的每张图片同样计费。Starter 每月 400 积分、9.99 美元，Pro 每月 1,400 积分、29.99 美元，订阅期内未使用的积分可滚存。
- 您可以用 50 个初始积分在 ImgGen 网页工具中免费去除水印，无需信用卡。API 本身包含在 Starter 与 Pro 付费套餐中。免费的水印移除 API 通常只是试用版或限速极严的演示，而不是能拿来做产品的东西。
- 通用助手有时确实能编辑图片，但它们并不是为此而生的：它们无法可靠地检测水印，往往会重绘整张图片而不是只重建受影响的区域，而且没有稳定的请求形式可供自动化对接。专用的修补端点能给您一致的输出，以及一份可以依赖的接口约定。
- 这完全取决于图片归谁所有。去除您自己拍摄的照片、或您已获授权可编辑的素材上的水印，没有问题。去除他人受版权保护作品上的水印以便未经许可使用，则不然——本端点也不是为此设计的。
- 该 API 接受 JPEG（JPG）、PNG 和 WebP 文件，每张图片最大 25 MB。结果以 base64 编码的图像形式在 JSON 响应中返回。
- 不会。该 API 是无状态的：它不会创建项目、不会保存文件，也不会保留您的图像。您上传的文件会写入一个临时对象，处理完成后在响应返回的同时立即删除。唯一保留的是一条使用日志，记录发生过一次调用以及消耗了多少积分。您的图像绝不会用于训练模型。
- 通过 API 不行。视频水印移除在 imggen.ai 上以网页工具形式提供，但 API 中没有视频端点——所有 /v1 路由处理的都是单张图片。