API для увеличения изображений: руководство по интеграции

Раньше для интеграции апскейлинга в приложение нужно было тренировать собственные AI-модели. Месяцы работы и большой бюджет на GPU. С API UpscaleIMG вы отправляете изображение и получаете чёткую увеличенную версию за секунды.

Этот гайд покажет, как интегрировать UpscaleIMG в ваш проект. С реальными примерами кода и всеми доступными опциями.

Что может API UpscaleIMG?

API UpscaleIMG использует Real-ESRGAN — мощную AI-модель для супер-разрешения изображений. Вы отправляете фото, а AI добавляет реалистичные детали при увеличении. Края остаются чёткими. Текстуры выглядят естественно. Лица сохраняют свои черты.

Что вы получаете:

• Апскейлинг в 2x и 4x с улучшением деталей через AI
• Пользовательские размеры для точного размера выхода
• Конвертация форматов между PNG, JPG и WebP
• Управление метаданными удаление или сохранение EXIF
• До 64 мегапикселей разрешения на выходе

Вся AI-обработка выполняется на наших серверах. GPU не нужен. Настройка моделей не нужна. Отправьте HTTP-запрос и получите результат.

Как начать работу с API?

Для запросов нужен API-ключ. Получить просто:

1. Создайте аккаунт на upscaleimg.app
2. Перейдите в панель управления и сгенерируйте API-ключ
3. Храните его безопасно на сервере

Эндпоинт API:

POST https://upscaleimg.app/api/v1/upscale

Аутентификация через Bearer-токен в заголовке Authorization. Держите API-ключ на сервере. Не показывайте его в клиентском коде и не коммитьте в репозиторий.

Бесплатные аккаунты получают апскейлинг в 2x. Подписчики открывают 4x и пользовательские размеры до 4x от оригинала.

Как увеличить первое изображение?

Самый простой вызов — изображение и коэффициент масштабирования. Пример curl для 2x:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "scale=2"

API возвращает JSON с деталями оригинала и результата:

{
  "original": {
    "size": 384000,
    "width": 1920,
    "height": 1080,
    "mimeType": "image/jpeg",
    "fileExt": "jpg"
  },
  "result": {
    "size": 1280000,
    "width": 3840,
    "height": 2160,
    "mimeType": "image/png",
    "fileExt": "png",
    "url": "https://..."
  }
}

В поле url — подписанная ссылка для скачивания. Подписанные URL быстро истекают, скачивайте сразу.

JavaScript:

const form = new FormData();
form.append('image', fileInput.files[0]);
form.append('scale', '2');

const response = await fetch('https://upscaleimg.app/api/v1/upscale', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: form
});

const data = await response.json();
console.log(`Увеличено до ${data.result.width}x${data.result.height}`);

Python:

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://upscaleimg.app/api/v1/upscale',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        files={'image': f},
        data={'scale': '2'}
    )

data = response.json()
print(f"Увеличено до {data['result']['width']}x{data['result']['height']}")

Какие опции поддерживает API?

API принимает несколько параметров через multipart-данные. Полный список:

Параметр	Обязат.	Значения	Описание
image	Да	Файл	PNG, JPG, JPEG или WebP
scale	Да*	2 или 4	Коэффициент апскейлинга. *Не нужен при пользовательских размерах.
customWidth	Нет	Целое	Целевая ширина (макс. 4x)
customHeight	Нет	Целое	Целевая высота (макс. 4x)
objectFit	Нет	cover, contain, fill	Режим подгонки. По умолчанию: cover.
outputFormat	Нет	jpg, jpeg, png, webp	Формат выхода. По умолчанию: png.
removeMetadata	Нет	1 или 0	Удалить EXIF. По умолчанию: 0 (сохранить).

Пользовательские размеры дают точный контроль. customWidth и customHeight указываются вместе. Результат не может быть меньше оригинала или больше 4x (для бесплатных аккаунтов 2x).

Пример: апскейл до 3000x2000 в WebP:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "customWidth=3000" \
  -F "customHeight=2000" \
  -F "objectFit=cover" \
  -F "outputFormat=webp" \
  -F "removeMetadata=1"

Как обрабатывать ошибки и рейт-лимиты?

API возвращает стандартные HTTP-коды:

Статус	Значение
200	Успех. Увеличенное изображение возвращено.
400	Неверный запрос. Нет изображения, неверный коэффициент, размер вне диапазона.
401	Неверный или отсутствующий API-ключ.
403	Запрещено. Попытка 4x без подписки или ошибка CORS.
429	Рейт-лимит. Слишком много запросов.
500	Ошибка сервера. Попробуйте снова.

Все ошибки содержат сообщение:

{"error": "4x upscaling is only available with an active subscription."}

При рейт-лимитах добавьте ретрай с бэкоффом:

async function upscaleWithRetry(form, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch('https://upscaleimg.app/api/v1/upscale', {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
      body: form
    });

    if (res.status === 429) {
      await new Promise(r => setTimeout(r, 2000 * (i + 1)));
      continue;
    }

    return await res.json();
  }
  throw new Error('Max retries reached');
}

Лучшие сценарии использования

API UpscaleIMG отлично вписывается в разные задачи.

E-commerce платформы используют его для улучшения фото товаров продавцов. Многие загрузки маленькие или низкого качества. Автоматический апскейлинг делает каждое объявление профессиональнее. Подробнее об увеличении без потери качества.

Печать по требованию требует файлов высокого разрешения. Клиенты загружают изображения, которые хорошо смотрятся на экране, но слишком малы для печати. Можно даже увеличить до 4K.

Приложения для реставрации фото сочетают апскейлинг с другими улучшениями. Старые или размытые фото становятся чёткими и увеличиваются.

CMS могут улучшать изображения автоматически при загрузке. Каждое изображение будет соответствовать минимальному стандарту качества.

Сайты недвижимости получают единообразное качество фото. Риелторы снимают разными камерами, но автоматический апскейлинг даёт профессиональный вид.

Для пакетной обработки смотрите наше руководство по автоматизации апскейлинга изображений. Также можно сравнить лучшие апскейлеры.

Готовы начать?

Рабочая интеграция будет готова менее чем за час. Создайте аккаунт на upscaleimg.app, получите API-ключ и отправьте первое тестовое изображение.

Начните с 2x на нескольких картинках для проверки качества. Потом встройте в свой пайплайн. Полное руководство по апскейлингу изображений охватывает всё остальное.

Бесплатного плана хватит для тестов и создания прототипа. Когда понадобится 4x и большие объёмы, переходите на платный план.