2 кредита за вызов
API удаления текста
Стирайте подписи, надписи, временные метки и впечатанные ярлыки с изображений программно. Обнаружение автоматическое — а если текста на изображении нет, с вас ничего не спишут.
- REST · JSON
- Без водяного знака
- Ничего не хранится
POST /v1/remove-text
Что такое API удаления текста?
API удаления текста ImgGen AI — это REST-эндпоинт, который находит текст на изображении и удаляет его, восстанавливая фон там, где были символы. Он справляется с подписями, надписями, временными метками и впечатанными ярлыками без маски. Если модель не находит текста, запрос возвращает 422 и кредиты не списываются.
Это один из семи эндпоинтов API редактирования изображений ImgGen AI: у всех общий ключ API, общий базовый URL и одинаковый формат запроса и ответа. Если эта возможность нужна вам ещё и в браузере, а не только из кода, — та же модель ИИ работает в инструменте Image Text Remover.
Параметры запроса
Отправьте POST-запрос на https://app.imggen.ai/v1/remove-text с аутентификацией по ключу API в заголовке Authorization.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
| image | file | ОБЯЗАТЕЛЬНЫЙ | — | The image to clean. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
Как встроить API удаления текста с изображений?
Создайте ключ API в аккаунте ImgGen, сохраните его в переменной окружения и вызовите эндпоинт. Вот один и тот же запрос на 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 МБ и отвечает синхронно в пределах 60 секунд — не нужно опрашивать задачу и настраивать вебхук.
Нет текста — нет списания
Если модель не находит текста на изображении, эндпоинт возвращает 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, и кредиты не спишутся. Поэтому эндпоинт безопасно запускать на смешанном пакете «на всякий случай» — вы платите только за изображения, на которых действительно был текст.
- Именно это эндпоинт и делает. Вместо закрашивания символов он находит область текста, удаляет её и восстанавливает скрытый за ней фон, опираясь на соседние пиксели. Всё за пределами области текста остаётся нетронутым, так что остальная часть фотографии побитово совпадает с тем, что вы отправили.
- Да. Обнаружение охватывает всё изображение, поэтому каждая найденная область текста — подпись, метка времени в углу и ярлык посередине — удаляется в одном вызове. Учтите: объединять несколько *изображений* в один запрос здесь нельзя; отправляйте по одному изображению на запрос или используйте эндпоинт водяных знаков, если нужны пакетные загрузки.
- За пределами области текста — нет, эти пиксели проходят без изменений. Внутри содержимое генерируется, а не восстанавливается, поэтому насыщенный или очень детализированный фон реконструировать сложнее, чем однотонный. Разрешение на выходе совпадает с входным; ничего не уменьшается.
- Для этого используйте отдельный эндпоинт удаления водяных знаков. Он настроен на полупрозрачные, повторяющиеся или замощённые наложения, типичные для водяных знаков, и это единственный эндпоинт, который принимает пакетные загрузки. Этот же рассчитан на непрозрачный текст: подписи, временные метки и впечатанные ярлыки.
- Два кредита за успешный вызов и совсем ничего, когда текст не обнаружен. В Starter входит 400 кредитов в месяц за 9,99 $, в Pro — 1 400 за 29,99 $, и неиспользованные кредиты переносятся, пока подписка активна.
- Нет — обнаружение автоматическое и применяется ко всему изображению. Ни параметра области, ни ограничивающей рамки нет. Если нужно выборочное удаление, в веб-редакторе ImgGen есть кистевой удалитель объектов для такой работы вручную.
- API принимает файлы JPEG (JPG), PNG и WebP размером до 25 МБ на изображение. Результат возвращается в JSON-ответе в виде изображения в кодировке base64.
- Нет. API не хранит состояние: он не создаёт проект, не сохраняет файл и не оставляет у себя ваше изображение. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил. Ваши изображения никогда не используются для обучения моделей.
Начать
Начните вызывать API удаления текста
Один ключ открывает все семь эндпоинтов. Без водяного знака, с полными коммерческими правами, и ничто из отправленного вами не сохраняется после возврата ответа.
Получить ключ API