2 кредита за вызов
API реставрации фотографий
Восстанавливайте старые, повреждённые и выцветшие фотографии из собственного бэкенда. При желании колоризируйте и повышайте разрешение в том же запросе, вместо цепочки из трёх вызовов.
- REST · JSON
- Без водяного знака
- Ничего не хранится
POST /v1/image-restoration
Что такое API реставрации фотографий?
API реставрации фотографий ImgGen AI — это REST-эндпоинт, который восстанавливает повреждённые снимки. Он уменьшает царапины, разрывы, пятна, выцветание и размытие, а при желании может добавить цвет чёрно-белому оригиналу и повысить его разрешение в том же вызове. Вы загружаете скан, и восстановленное изображение возвращается в ответе.
Это один из семи эндпоинтов API редактирования изображений ImgGen AI: у всех общий ключ API, общий базовый URL и одинаковый формат запроса и ответа. Если эта возможность нужна вам ещё и в браузере, а не только из кода, — та же модель ИИ работает в инструменте Image Restoration.
Параметры запроса
Отправьте POST-запрос на https://app.imggen.ai/v1/image-restoration с аутентификацией по ключу API в заголовке Authorization.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
| image | file | ОБЯЗАТЕЛЬНЫЙ | — | Добавляет реалистичный цвет чёрно-белой фотографии в процессе реставрации. |
| colorize | boolean | необязательный | false | Устраняет царапины, разрывы и физические повреждения. |
| removeTears | boolean | необязательный | false | Увеличивает разрешение восстановленного изображения. Добавляет к вызову стоимость апскейлера. |
| enhanceResolution | boolean | необязательный | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
Как встроить API реставрации фотографий?
Создайте ключ API в аккаунте ImgGen, сохраните его в переменной окружения и вызовите эндпоинт. Вот один и тот же запрос на cURL, Node.js и Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/image-restoration' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form colorize=false \
--form removeTears=true \
--form enhanceResolution=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('colorize', 'false');
form.append('removeTears', 'true');
form.append('enhanceResolution', 'false');
const res = await fetch('https://app.imggen.ai/v1/image-restoration', {
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/image-restoration",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"colorize": "false", "removeTears": "true", "enhanceResolution": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))Ответ
Успешный вызов возвращает JSON. Результат приходит в кодировке base64 — декодируйте его перед записью на диск или в объектное хранилище. Каждый успешный ответ также содержит заголовок X-Credit-Remaining с вашим балансом после вызова.
{
"success": true,
"message": "Image restored successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Ограничения и поведение, о которых стоит знать
Эндпоинт принимает JPEG (JPG), PNG и WebP с максимальным размером файла 25 МБ и отвечает синхронно в пределах 60 секунд — не нужно опрашивать задачу и настраивать вебхук.
Три операции, один вызов
Восстановление, колоризация и увеличение — это флаги одного запроса, а не отдельные эндпоинты, поэтому полная реставрация укладывается в один цикл вместо трёх.
enhanceResolution стоит дороже
Включение enhanceResolution добавляет стоимость апскейлера к базовой цене реставрации, потому что дополнительно запускается модель увеличения.
Качество скана имеет значение
Модель восстанавливает по тому, что видит. Ровный, равномерно освещённый скан на максимальном разрешении вашего сканера даёт заметно лучший результат, чем снимок отпечатка на телефон.
Для чего используют 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-эндпоинт, который автоматически восстанавливает повреждённые фотографии. Он уменьшает царапины, разрывы, пятна, выцветание и размытие, а при желании колоризирует и увеличивает результат. Он существует, чтобы продукт мог предложить реставрацию пользователям без ручной ретуши.
- Да. Поставьте colorize=true, и модель добавит реалистичный цвет в том же проходе реставрации. Если нужен только цвет, а фотография не повреждена, отдельный эндпоинт колоризации дешевле и прямее.
- Два кредита за успешный вызов. enhanceResolution=true добавляет сверху стоимость апскейлера, потому что запускается вторая модель. В Starter входит 400 кредитов в месяц за 9,99 $, в Pro — 1 400 за 29,99 $, и неиспользованные кредиты переносятся, пока вы остаётесь подписчиком.
- Царапины, разрывы, пятна, следы воды, потерю цвета, пожелтение и общую нерезкость. Для физических повреждений ставьте removeTears=true. Области, где исходного содержимого не осталось вовсе, восстанавливаются правдоподобно, а не возвращаются: модель домысливает, а не отменяет.
- Может, и это стоит понимать до того, как показывать её пользователям. Модель восстанавливает недостающую информацию домысливанием, поэтому сильно повреждённое или очень низкого разрешения лицо может вернуться слегка отличающимся от человека на оригинале. Она работает с тем, что видно; там, где не видно ничего, она выдаёт правдоподобное предположение. Считайте результат восстановленной интерпретацией, а не возвращённым оригиналом.
- Одна фотография на запрос. У этого эндпоинта нет пакетной формы — image[] поддерживает только удаление водяных знаков. Для целого архива отправляйте запросы параллельно из собственного воркера; каждый независим и оплачивается отдельно.
- API принимает файлы JPEG (JPG), PNG и WebP размером до 25 МБ на изображение. Результат возвращается в JSON-ответе в виде изображения в кодировке base64.
- Нет. API не хранит состояние: он не создаёт проект, не сохраняет файл и не оставляет у себя ваше изображение. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил. Ваши изображения никогда не используются для обучения моделей.
- Да. Все тарифы, включая бесплатный, дают полные коммерческие права на использование, и ни один результат не содержит водяного знака. Всё, что возвращает API, вы можете продавать, печатать или публиковать.
Начать
Начните вызывать API реставрации фотографий
Один ключ открывает все семь эндпоинтов. Без водяного знака, с полными коммерческими правами, и ничто из отправленного вами не сохраняется после возврата ответа.
Получить ключ API