2 кредита за вызов
API удаления водяных знаков
Находите и стирайте водяные знаки за один запрос. Генеративный инпейнтинг восстанавливает пиксели под знаком, и это единственный эндпоинт, который также принимает пакет изображений.
- REST · JSON
- Без водяного знака
- Ничего не хранится
POST /v1/remove-watermark
Что такое API удаления водяных знаков?
API удаления водяных знаков ImgGen AI — это REST-эндпоинт, который находит водяной знак на изображении и восстанавливает содержимое под ним. Обнаружение автоматическое, поэтому маска не нужна, а генеративный инпейнтинг заполняет освобождённую область в тон окружению, а не размывает её. Очищенное изображение возвращается в том же ответе.
Это один из семи эндпоинтов API редактирования изображений ImgGen AI: у всех общий ключ API, общий базовый URL и одинаковый формат запроса и ответа. Если эта возможность нужна вам ещё и в браузере, а не только из кода, — та же модель ИИ работает в инструменте Watermark Remover.
Параметры запроса
Отправьте POST-запрос на https://app.imggen.ai/v1/remove-watermark с аутентификацией по ключу API в заголовке Authorization.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
| 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 удаления водяных знаков?
Создайте ключ API в аккаунте ImgGen, сохраните его в переменной окружения и вызовите эндпоинт. Вот один и тот же запрос на 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 МБ и отвечает синхронно в пределах 60 секунд — не нужно опрашивать задачу и настраивать вебхук.
Пакетные загрузки
Это единственный эндпоинт 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 для того, что обработать не удалось. Все остальные эндпоинты принимают одно изображение за запрос.
- Два кредита за каждое успешно обработанное изображение, включая каждое изображение в пакете. В Starter входит 400 кредитов в месяц за 9,99 $, в Pro — 1 400 за 29,99 $, и неиспользованные кредиты переносятся, пока подписка активна.
- Убрать водяные знаки бесплатно можно в веб-инструменте ImgGen, используя стартовые 50 кредитов и без привязки карты. Сам API входит в платные тарифы Starter и Pro. Бесплатные API удаления водяных знаков обычно существуют как пробные версии или сильно урезанные демо, а не как основа для продукта.
- Универсальные ассистенты иногда умеют редактировать изображение, но они не для этого сделаны: они ненадёжно находят знак, часто перерисовывают изображение целиком вместо восстановления только затронутой области, и у них нет стабильной формы запроса, под которую можно автоматизировать. Отдельный эндпоинт инпейнтинга даёт предсказуемый результат и контракт, на который можно опереться.
- Это целиком зависит от того, кому принадлежит изображение. Убрать водяной знак со своих фотографий или с материалов, которые вы лицензировали с правом редактирования, — не проблема. Убрать его с чужого охраняемого произведения, чтобы использовать без разрешения, — проблема, и для этого данный эндпоинт не предназначен.
- API принимает файлы JPEG (JPG), PNG и WebP размером до 25 МБ на изображение. Результат возвращается в JSON-ответе в виде изображения в кодировке base64.
- Нет. API не хранит состояние: он не создаёт проект, не сохраняет файл и не оставляет у себя ваше изображение. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил. Ваши изображения никогда не используются для обучения моделей.
- Через API — нет. Удаление водяных знаков с видео доступно как веб-инструмент на imggen.ai, но в API нет видео-эндпоинта: все маршруты /v1 обрабатывают отдельные изображения.
Начать
Начните вызывать API удаления водяных знаков
Один ключ открывает все семь эндпоинтов. Без водяного знака, с полными коммерческими правами, и ничто из отправленного вами не сохраняется после возврата ответа.
Получить ключ API