2–4 кредита за вызов
API увеличения разрешения
Поднимайте разрешение изображений в 2 или 4 раза из собственного бэкенда. Опциональное улучшение лиц и повышение резкости, вывод в JPEG или PNG и цена, которая масштабируется вместе с выбранным множителем.
- REST · JSON
- Без водяного знака
- Ничего не хранится
POST /v1/upscale-image
Что такое API увеличения разрешения?
API увеличения разрешения ImgGen AI — это REST-эндпоинт, который повышает разрешение изображения средствами ИИ, а не простой интерполяцией. Он восстанавливает края, текстуры и мелкие детали вместо растягивания пикселей, поэтому результат остаётся чётким. Вы отправляете изображение и множитель, а результат в большем разрешении возвращается в том же запросе.
Это один из семи эндпоинтов API редактирования изображений ImgGen AI: у всех общий ключ API, общий базовый URL и одинаковый формат запроса и ответа. Если эта возможность нужна вам ещё и в браузере, а не только из кода, — та же модель ИИ работает в инструменте AI Image Upscaler.
Параметры запроса
Отправьте POST-запрос на https://app.imggen.ai/v1/upscale-image с аутентификацией по ключу API в заголовке Authorization.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
| image | file | ОБЯЗАТЕЛЬНЫЙ | — | Множитель увеличения. Принимает 2 или 4. |
| factor | number | необязательный | 4 | Применяет дополнительное восстановление лиц. Полезно для портретов и групповых фотографий. |
| enhanceFace | boolean | необязательный | false | Применяет дополнительное повышение резкости к увеличенному результату. |
| sharpen | boolean | необязательный | false | Формат вывода. Принимает jpeg или png. |
| output | string | необязательный | jpeg | Output format. Accepts jpeg or png. |
Как встроить API увеличения разрешения?
Создайте ключ API в аккаунте ImgGen, сохраните его в переменной окружения и вызовите эндпоинт. Вот один и тот же запрос на cURL, Node.js и Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/upscale-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form factor=4 \
--form enhanceFace=false \
--form sharpen=false \
--form output=jpegimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');
const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
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/upscale-image",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
)
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 upscaled successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Ограничения и поведение, о которых стоит знать
Эндпоинт принимает JPEG (JPG), PNG и WebP с максимальным размером файла 25 МБ и отвечает синхронно в пределах 60 секунд — не нужно опрашивать задачу и настраивать вебхук.
Выберите формат вывода
Ставьте output=png, когда нужен результат без потерь или требуется сохранить альфа-канал; jpeg удерживает ответы лёгкими для каталогов большого объёма.
Улучшение лиц — по желанию
enhanceFace выполняет дополнительное восстановление лиц, чтобы улучшить и увеличить портреты. Оставьте его выключенным для предметной съёмки и пейзажей, где улучшать нечего.
Synchronous by design
There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.
Для чего используют API увеличения разрешения?
Где команды используют этот эндпоинт в продакшене, чтобы обрабатывать изображения программно и в больших объёмах.
Перенос старого каталога
Доведите годами накопленные маленькие товарные изображения низкого разрешения до современных стандартов пакетной обработкой, вместо того чтобы переснимать их.
Подготовка к печати
Поднимите веб-материалы до размера, который выдержит печать, с опциональным повышением резкости в том же вызове для более чёткого результата.
Пользовательский контент
Увеличивайте маленькие аватары и загрузки на стороне сервера, чтобы они выглядели чисто на экранах с высокой плотностью пикселей.
Медиа и архивы
Повышайте разрешение отсканированных или сжатых исходников перед их попаданием в систему управления контентом — вместе с реставрацией, когда она нужна.
Сколько стоит API увеличения разрешения?
Каждый успешный вызов стоит 2–4 кредита, поэтому фактическая стоимость изображения зависит от вашего тарифа. Кредиты берутся из вашего тарифа и общие для всех эндпоинтов и веб-редактора, так что отдельную квоту на каждый инструмент покупать не нужно. Неудачный вызов возвращается автоматически. Все подробности — на странице тарифов.
| Тариф | Цена | Кредиты | 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-эндпоинт, который повышает разрешение изображения с помощью обученной модели. Вместо интерполяции между существующими пикселями, как при обычном ресайзе, модель предсказывает детали, которые содержала бы версия изображения в большем разрешении — края, текстуру и структуру, — и восстанавливает их. Вы отправляете изображение POST-запросом и читаете увеличенный результат из ответа.
- Параметр factor принимает 2 или 4, по умолчанию 4. На вход можно подавать JPEG (JPG), PNG и WebP до 25 МБ, а вывод возвращается в jpeg (по умолчанию) или png.
- Стоимость следует за множителем: 2 кредита при factor=2 и 4 кредита при factor=4 (значение по умолчанию). Starter даёт 400 кредитов в месяц за 9,99 $, Pro — 1 400 за 29,99 $, и неиспользованные кредиты переносятся, пока вы остаётесь подписчиком. Оплата кредитами означает, что месяц с большим объёмом и спокойный месяц стоят одинаково в пересчёте на изображение.
- Увеличение восстанавливает детали при масштабировании, что попутно повышает чёткость мягких изображений, а флаг sharpen усиливает этот эффект. Для повреждённых или выцветших фотографий — царапины, разрывы, потеря цвета — используйте API реставрации фотографий, он рассчитан на ремонт, а не на разрешение.
- Синхронное. Не нужно опрашивать идентификатор задачи или настраивать вебхук — увеличенное изображение приходит в теле того же ответа, с ограничением в 60 секунд на запрос.
- Да. Все тарифы, включая бесплатный, дают полные коммерческие права на использование, и ни один результат не содержит водяного знака. Всё, что возвращает API, вы можете продавать, печатать или публиковать.
- Нет. API не хранит состояние: он не создаёт проект, не сохраняет файл и не оставляет у себя ваше изображение. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил. Ваши изображения никогда не используются для обучения моделей.
Начать
Начните вызывать API увеличения разрешения
Один ключ открывает все семь эндпоинтов. Без водяного знака, с полными коммерческими правами, и ничто из отправленного вами не сохраняется после возврата ответа.
Получить ключ API