API ДЛЯ РАЗРАБОТЧИКОВ · ОТКРЫТАЯ БЕТА

API MegaPotato

Увеличивайте фото прямо из своего кода — с той же моделью и по тем же ценам в чипсах, что на сайте. Всего два запроса: отправить фото и забрать результат. В нашем сравнении 18 ИИ-сервисов увеличения фото в октябре 2026 года модель заняла первое место и оказалась самой дешёвой среди лидеров.

На этой странице

Быстрый старт

Создайте ключ на странице аккаунта, сохраните его в переменной окружения MEGAPOTATO_API_KEY и выполните:

shell
# 1. Отправьте фото
curl https://megapotato.app/v1/upscale \
  -H "Authorization: Bearer $MEGAPOTATO_API_KEY" \
  -H "Idempotency-Key: photo-001" \
  -F file=@photo.jpg \
  -F upscale=4
# → {"id": "6f6f4c1e-…", "status": "queued", "upscale": 4, "cost_chips": 2}

# 2. Дождитесь результата (сервер удерживает запрос до 55 с)
curl "https://megapotato.app/v1/jobs/6f6f4c1e-…?wait=55" \
  -H "Authorization: Bearer $MEGAPOTATO_API_KEY"
# → {"status": "completed", "result_url": "https://…", …}

Попробовать без ключа

Без аккаунта и ключа: отправьте фото на /v1/try и опрашивайте /v1/try/{id}. Это настоящая обработка той же моделью. Поле cost_chips показывает стоимость с ключом, но чипсы не списываются. Пробные задания идут после всех заданий с ключом, поэтому при высокой нагрузке ожидание может быть дольше. Пробный режим ограничен бюджетом: 429 означает, что нужно подождать указанное в Retry-After время или получить ключ, а 403 — что режим закрыт. Сейчас недоступно. Используйте тестовый ключ или ключ API со страницы аккаунта.

shell
# 1. Отправьте фото (без аккаунта и ключа)
curl https://megapotato.app/v1/try -F file=@photo.jpg -F upscale=4
# → {"id": "6f6f4c1e-…", "status": "queued", "upscale": 4, "cost_chips": 2}

# 2. Дождитесь результата (сервер удерживает запрос до 55 с)
curl "https://megapotato.app/v1/try/6f6f4c1e-…?wait=55"
# → {"status": "completed", "result_url": "https://…", …}

Тестовые ключи

Хотите настроить интеграцию до покупки чипсов? Войдите и создайте тестовый ключ (mp_test_…) на странице аккаунта. Он проходит весь цикл: загрузки проверяются, стоимость рассчитывается так же, как с рабочим ключом. Но обработка не запускается и чипсы не списываются: каждое задание возвращается со статусом completed и примером изображения в result_url и result_jpeg_url. Поле jpeg_status всегда равно ready, даже без jpeg=true. Повторный запрос с теми же Idempotency-Key и фото возвращает тот же ID задания. Повторное использование ключа для другого фото отклоняется (422) только с рабочими ключами. Когда будете готовы, переключитесь на рабочий ключ. Рабочие ключи станут доступны после покупки первого пакета чипсов.

Аутентификация

В каждом запросе передавайте ключ в заголовке Authorization: Bearer mp_live_…. Ключ показывается только при создании — мы храним лишь его хеш. Храните ключи на сервере, а не в мобильном приложении, на веб-странице или в репозитории. При утечке отзовите ключ на странице аккаунта — он сразу перестанет работать.

Узнать цену — POST /v1/quote

Отправьте исходный размер и масштаб, получите цену. Фото не загружается, чипсы не списываются.

shell
curl https://megapotato.app/v1/quote \
  -H "Authorization: Bearer $MEGAPOTATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width": 4032, "height": 3024, "upscale": 2}'
# → {"cost_chips": 5, "output_width": 8064, "output_height": 6048, "upscale": 2}

Увеличить фото — POST /v1/upscale

Форма multipart с file (PNG, JPG, WEBP и HEIC, до 40 МБ) и upscale: 1 (детализация, исходный размер), 2, 4 или 8. Длинная сторона исходного фото — до 6 000 px, результата — до 16 400 px. Для больших фото выбирайте меньший масштаб.

response
{"id": "6f6f4c1e-…", "status": "queued", "upscale": 4, "cost_chips": 2}

cost_chips сразу резервируется на балансе и списывается, когда фото готово. Если обработка не удалась, чипсы возвращаются автоматически.

Необязательный параметр jpeg=true добавляет к PNG полноразмерный JPEG результата (качество 92, без прореживания цветности) без доплаты. PNG без потерь в 16K может весить несколько сотен МБ, а JPEG того же результата обычно гораздо меньше. В задании появляются result_jpeg_url и jpeg_status. Повторное использование Idempotency-Key с другим фото, upscale или jpeg возвращает 422.

Получить результат — GET /v1/jobs/{id}

Добавьте ?wait=55 — сервер удержит запрос до завершения задания или истечения 55 секунд. Обычно одного запроса хватает на всё задание.

Большинство фото готовы за секунды. При росте нагрузки мы подключаем дополнительные мощности, и первые запросы после этого могут занять пару минут. Затем всё работает на полной скорости. Продолжайте опрос с ?wait=55 — дополнительных действий не нужно.

response
{
  "id": "6f6f4c1e-…",
  "status": "completed",          // queued → running → completed | failed
  "result_url": "https://…",      // PNG; ссылка действует около часа, заголовок авторизации не нужен
  "error": null,                  // причина ошибки с сообщением «чипсы возвращены»
  "upscale": 4,
  "created_at": "2026-09-15T10:00:00Z",
  "eta_seconds": null,            // примерное время для задания в очереди или в обработке
  "result_jpeg_url": "https://…", // с jpeg=true: полноразмерный JPEG, правила те же, что для result_url
  "jpeg_status": "ready"          // null без jpeg=true; pending → ready | unavailable
}

Запросите задание ещё раз, чтобы получить свежий result_url. Срок доступа к результатам — 90 дн.

jpeg_status равен pending, пока задание в очереди или обрабатывается; ready, когда заполнен result_jpeg_url; unavailable, если задание завершилось без JPEG (PNG всё равно доступен), завершилось с ошибкой или срок хранения истёк. Без jpeg=true оба поля равны null. Исключение — тестовые ключи: оба URL ведут на пример изображения, а jpeg_status всегда равен ready.

У задания со статусом completed JPEG ещё может быть в состоянии pending, пока идёт его загрузка. Обычно это секунды, в редких случаях — до часа. result_url уже работает, а повторный опрос вернёт result_jpeg_url или unavailable, если JPEG так и не появился.

Ошибки

У всех ошибок одинаковая структура:

response
{"error": {"type": "insufficient_credits", "message": "insufficient chips: available 0, needed 2"}}
  • 400 · invalid_request_error
    Не удалось декодировать изображение или его размер превышает лимит.
  • 401 · authentication_error
    Ключ отсутствует, неверен или отозван.
  • 402 · insufficient_credits
    Не хватает чипсов для этого фото — нужное количество указано в сообщении.
  • 404 · invalid_request_error
    Задание не найдено или принадлежит не вам.
  • 413 · invalid_request_error
    Файл превышает лимит загрузки.
  • 415 · invalid_request_error
    Формат изображения не поддерживается.
  • 422 · invalid_request_error
    Неверное значение upscale или jpeg, отсутствует файл либо Idempotency-Key повторно использован с другим фото, upscale или jpeg.
  • 429 · rate_limit_error
    Слишком много запросов или фото в обработке одновременно. Подождите время из Retry-After.
  • 422 · content_not_allowed
    Наша автоматическая проверка контента заблокировала изображение (см. Условия использования). Чипсы не списаны.
  • 429 · spend_limit_reached
    Дневной лимит расходов API исчерпан. Обновится в 00:00 UTC.
  • 500 · server_error
    Ошибка на нашей стороне. Повторите запрос — для загрузки используйте тот же Idempotency-Key.
  • 503 · service_unavailable
    Сейчас мы не можем принимать изображения. Чипсы не списаны. Повторите запрос через время из Retry-After.

Лимиты

  • До 10 фото в обработке одновременно на аккаунт. При превышении новая загрузка получит 429, чипсы не спишутся.
  • До 100 загрузок в минуту на ключ. Для запросов статуса лимит выше.
  • Дневной лимит расходов через API (сутки по UTC) защищает баланс при утечке ключа. По умолчанию — 5 000 чипсов в день. На странице аккаунта можно установить меньший лимит.

Цены

Для одного фото и масштаба цена в API точно такая же, как на сайте. Чипсы списываются с общего баланса. Чем больше результат, тем выше цена: увеличение фото на 1 МП в 4 раза стоит около 2 чипса, а фото с телефона на 12 МП в 2 раза — около 5 чипсов. Один чипс стоит $0.033–0.05 в зависимости от пакета. Узнать цену для любого размера можно через /v1/quote. При ошибке обработки чипсы возвращаются автоматически. Купить их можно на странице цен — они не сгорают.

Повторные запросы

  • При загрузке всегда передавайте Idempotency-Key — до 128 символов, уникальный для каждого фото. Повторный запрос с тем же ключом вернёт то же задание, а оплата спишется один раз. После тайм-аута можно смело повторять запрос.
  • При 429 подождите время из Retry-After. При 5xx или ошибке сети повторяйте запрос с растущей паузой (1 с, 2 с, 4 с…). При других ошибках 4xx повтор не поможет — исправьте запрос.
  • Используйте опрос с ?wait=55, а не запросы каждую секунду.

Бета и версии

API находится в открытой бете: пока без гарантии бесперебойной работы. О плановых изменениях сообщим по почте. В /v1 мы только добавляем новые поля и типы ошибок, поэтому игнорируйте незнакомые поля. Изменения, нарушающие совместимость, выйдут в /v2 — предупредим минимум за 90 дней.

Правила использования

Результаты принадлежат вам. Используйте API только для изображений, которые имеете право обрабатывать. Запрещены незаконный контент, сексуальный контент с несовершеннолетними и интимные изображения людей без их согласия. За нарушение этих правил или Условий использования аккаунты блокируются. О нарушениях пишите на abuse@megapotato.app, с вопросами — на support@megapotato.app.

Получить ключ API

Спецификация, примеры, узел