v1 · 7 эндпоинтов · в работе
Редактирование изображений
API для разработчиков
Семь ИИ-эндпоинтов обработки изображений за одним ключом API: удаление фона, увеличение разрешения, удаление водяных знаков и текста, реставрация, колоризация и текст в изображение. Обычный REST, JSON-ответ и ничего не сохраняется после завершения вызова.
- 7 эндпоинтов, 1 ключ
- REST поверх HTTPS
- Без водяного знака
- Ничего не хранится
$ 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..."
}Что такое API редактирования изображений ImgGen AI?
API редактирования изображений ImgGen AI — это REST-сервис, который выполняет обработку изображений с помощью ИИ по запросу. Вы отправляете изображение — или текстовый промпт — на эндпоинт по HTTPS, и обработанный результат возвращается в JSON-ответе в кодировке base64. Не нужно размещать модель и выделять 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 колоризации фотографий
Превращайте чёрно-белые фотографии в изображения с естественным цветом одним запросом. При желании устранение разрывов в том же вызове — и никакого ручного подбора цвета ни на одном шаге.
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
Намеренно скучно: один запрос, один ответ и никакой оркестрации с вашей стороны.
Синхронно, без очередей
Обработанное изображение приходит в теле того же ответа. Не нужно опрашивать идентификатор задачи, поднимать эндпоинт для вебхука или сверять очередь. На запросы действует ограничение в 60 секунд.
Multipart на входе, base64 на выходе
Отправляйте исходное изображение как multipart-форму — JPEG (JPG), PNG и WebP до 25 МБ. Результат возвращается в теле JSON в кодировке base64: декодируйте его и запишите туда, где вы храните файлы.
Списание только при успехе
Кредиты списываются атомарно и автоматически возвращаются, если обработка не удалась, поэтому вы платите только за изображения, которые действительно вернулись. Удаление текста даже возвращает 422 бесплатно, когда удалять нечего.
Ключи, которые можно ротировать
Ключи показываются один раз и хранятся только в виде хеша. Отзыв распространяется примерно за минуту, поэтому утёкший ключ — проблема на одну минуту, а не инцидент.
Хранит ли API мои изображения и обучается ли на них?
Нет. API не хранит состояние. В отличие от веб-редактора, который сохраняет проекты, чтобы вы могли к ним вернуться, вызов API не создаёт ни проекта, ни записи о задаче, ни сохранённого файла. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил.
Ваши изображения никогда не используются для обучения моделей. Это важно, если вы обрабатываете фотографии клиентов, которые по договору не имеете права хранить: их держит вне нашего хранилища сама архитектура, а не только политика.
Ответы с ошибками
При сбое возвращается JSON-обёртка вида { "error": { "message", "code" } }, где HTTP-статус соответствует коду.
| Статус | Код | Значение |
|---|---|---|
| 401 | UNAUTHORIZED | Ключ API отсутствует, некорректен или был отозван. |
| 402 | INSUFFICIENT_CREDITS | На вашем аккаунте недостаточно кредитов для этого вызова. |
| 403 | FORBIDDEN | Ваш тариф не даёт доступа к этому инструменту. |
| 404 | NOT_FOUND | Такого пути эндпоинта не существует. |
| 409 | CONFLICT | Запрос конфликтует с текущим состоянием ресурса. |
| 422 | VALIDATION_ERROR | Запрос отклонён — неподходящий тип файла, отсутствующее поле или нечего обрабатывать. Кредиты не списываются. |
Кто пользуется API ImgGen?
Где API обработки изображений оправдывает своё место в продукте.
E-commerce и маркетплейсы
Приводите изображения поставщиков и продавцов к единому виду прямо при загрузке — вырезайте фон, убирайте наложенный текст и увеличивайте старые снимки низкого разрешения, чтобы каждая карточка выглядела снятой в одной студии.
Печать по требованию и мокапы товаров
Выделяйте макет, поднимайте разрешение до полиграфического уровня и накладывайте на шаблоны без участия дизайнера в каждом заказе.
SaaS для дизайна и редактирования
Добавьте редактирование в один клик прямо в свой продукт, не размещая GPU, не дообучая модели и не поддерживая инференс-инфраструктуру.
Архивы, генеалогия и оцифровка
Реставрируйте, колоризируйте и увеличивайте отсканированные фотографии в автоматическом конвейере вместо ретуши каждого кадра вручную.
Контент- и издательские платформы
Генерируйте оригинальные изображения по промпту и очищайте загрузки авторов в рамках уже работающего редакционного процесса.
Агентства и внутренние инструменты
Автоматизируйте рутинную работу с изображениями между брифом клиента и готовым материалом — прямо из инструментов, которыми команда уже пользуется.
Вопросы об API редактирования изображений
- Да. API редактирования изображений ImgGen AI предоставляет семь REST-эндпоинтов — удаление фона, увеличение разрешения, удаление водяных знаков, удаление текста, реставрация фотографий, колоризация и генерация изображений по тексту — все на https://app.imggen.ai и все доступны по одному ключу API.
- Он выполняет конкретное редактирование над отправленным изображением и возвращает результат в том же ответе. Вы можете удалить фон и получить прозрачный PNG, увеличить в 2 или 4 раза, стереть водяные знаки или впечатанный текст, восстановить и колоризировать повреждённые фотографии и сгенерировать новые изображения по текстовому промпту.
- Создайте аккаунт ImgGen на https://editor.imggen.ai и сгенерируйте ключ в настройках аккаунта. Ключ показывается один раз и хранится только в виде хеша, поэтому скопируйте его в надёжное место: если он потеряется, вы создадите новый, а не восстановите старый. Отзыв ключа вступает в силу примерно за минуту.
- Отправляйте ключ как bearer-токен: Authorization: Bearer sk_live_… в каждом запросе. Ключи, выданные до текущей схемы, также могут аутентифицироваться через устаревший заголовок x-imggen-key, который по-прежнему принимается.
- Использование измеряется в кредитах, а не фиксированной платой за вызов, и стоимость зависит от эндпоинта: удаление фона — 1 кредит; удаление водяного знака, удаление текста, реставрация и колоризация — 2; увеличение разрешения — 2 при factor=2 и 4 при factor=4; генерация изображений начинается с 3 и зависит от модели. Starter даёт 400 кредитов в месяц за 9,99 $, Pro — 1 400 за 29,99 $, причём неиспользованные кредиты переносятся, пока подписка активна.
- Бесплатный аккаунт ImgGen включает 50 кредитов без привязки карты — этого достаточно, чтобы оценить модели в веб-инструментах. Сам доступ к API входит в платные тарифы Starter и Pro: постоянного бесплатного уровня API нет, и мы предпочитаем сказать это прямо, а не рекламировать тот, который затем незаметно ограничивает скорость.
- API принимает файлы JPEG (JPG), PNG и WebP размером до 25 МБ на изображение. Результат возвращается в JSON-ответе в виде изображения в кодировке base64.
- Синхронные. Не нужно опрашивать идентификатор задачи, управлять очередью или настраивать вебхук — обработанное изображение приходит в теле того же ответа. На запросы действует ограничение в 60 секунд.
- Нет. API не хранит состояние: он не создаёт проект, не сохраняет файл и не оставляет у себя ваше изображение. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил. Ваши изображения никогда не используются для обучения моделей.
- Да. Все тарифы, включая бесплатный, дают полные коммерческие права на использование, и ни один результат не содержит водяного знака. Всё, что возвращает API, вы можете продавать, печатать или публиковать.
- Эндпоинт удаления водяных знаков принимает пакет файлов в поле image[] и возвращает массив images. Все остальные эндпоинты обрабатывают одно изображение за запрос — для объёма отправляйте запросы параллельно из собственного воркера, так как каждый вызов независим.
- Пока нет. API — это обычный REST поверх HTTPS с multipart-загрузками, поэтому подойдёт любой HTTP-клиент, а в документации есть готовые примеры на cURL, Node.js и Python. Официальной клиентской библиотеки и опубликованной спецификации OpenAPI пока нет.
Начать
Первый вызов — за пять минут
Создайте ключ, скопируйте пример на cURL — и удаление фона уже работает. Один ключ покрывает все семь эндпоинтов на любом тарифе с доступом к API.
Получить ключ API