什么是文字移除 API？
ImgGen AI 文字移除 API 是一个 REST 端点，它定位图片中的文字并将其移除，同时重建字符原本所在位置的背景。它无需蒙版即可处理字幕、叠加文字、时间戳和嵌入标签。如果模型没有找到文字，请求会返回 422，且不扣除任何积分。
这是 ImgGen AI 图像编辑 API 七个端点之一，它们共用同一个 API 密钥、同一个基础 URL，以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能，同一套 AI 模型也驱动着 Image Text Remover 工具。
请求参数
向 https://app.imggen.ai/v1/remove-text 发送一个 POST 请求，并在 Authorization 请求头中使用 API 密钥进行认证。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| image | file | 必填 | — | The image to clean. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
如何集成图片文字移除 API？
在您的 ImgGen 账户中创建一个 API 密钥，将其设为环境变量，然后调用该端点。以下是同一个请求的 cURL、Node.js 与 Python 写法。
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-text' \
--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-text', {
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-text",
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": "Text removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}值得了解的限制与行为
该端点接受 JPEG（JPG）、PNG 和 WebP，文件最大 25 MB，并在 60 秒内同步返回结果——无需轮询任务，也无需配置 webhook。
没有文字，就不计费
如果模型在图片中未检测到文字，端点会返回 422 VALIDATION_ERROR，且不扣除任何积分。您可以放心地把它用在混合的图片集合上，而不必为本就干净的图片付费。
生成式填充，而非模糊
字符后方的区域会被重建得与周围一致，而不是被涂抹掉，因此在细节丰富的背景上结果依然经得起看。
自动检测
没有区域或边界框参数——模型会自行找到文字，这正是该端点可以无人值守运行的原因。
图片文字移除 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 端点，检测照片中的文字字符并将其擦除，同时填补被它们遮住的背景。这相当于在编辑器里手工用仿制图章去字的程序化版本，只不过它一秒内完成，且不需要人来标注区域。
- 请求会返回 HTTP 422 及 VALIDATION_ERROR 代码，且不计费。因此可以放心地对混合批次预先跑一遍——您只为真正含有文字的图片付费。
- 这正是该端点所做的事。它不是在字符上覆盖涂抹，而是先检测文字区域、将其移除，再以周围像素为参照重建被遮挡的背景。文字区域之外的一切保持原样，因此照片的其余部分与您发送的内容逐比特一致。
- 可以。检测覆盖整张图片，因此它找到的每一处文字区域——一段字幕、角落里的时间戳、画面中间的标签——都会在同一次调用中移除。请注意，此处不支持把多张*图片*合并到一个请求中；请每次请求发送一张图片，若需要批量上传请使用水印端点。
- 文字区域之外不会——那些像素原样通过。区域之内的内容是生成的而非还原的，因此杂乱或细节极丰富的背景比纯色背景更难重建。输出分辨率与输入一致，不会做任何缩小。
- 请改用专门的水印移除端点。它针对水印常见的半透明、重复或平铺叠加做过调优，也是唯一接受批量上传的端点。本端点针对的是不透明文字：字幕、时间戳和嵌入标签。
- 每次成功调用 2 积分，未检测到文字时完全不计费。Starter 每月 400 积分、9.99 美元，Pro 每月 1,400 积分、29.99 美元，订阅期内未使用的积分可滚存。
- 不行——检测是自动的，且作用于整张图片。没有区域或边界框参数。如果您需要有选择地移除，ImgGen 网页编辑器提供了基于画笔的对象移除工具，适合这类手动引导的工作。
- 该 API 接受 JPEG（JPG）、PNG 和 WebP 文件，每张图片最大 25 MB。结果以 base64 编码的图像形式在 JSON 响应中返回。
- 不会。该 API 是无状态的：它不会创建项目、不会保存文件，也不会保留您的图像。您上传的文件会写入一个临时对象，处理完成后在响应返回的同时立即删除。唯一保留的是一条使用日志，记录发生过一次调用以及消耗了多少积分。您的图像绝不会用于训练模型。