API MegaPotato
Увеличивайте фото прямо из своего кода — с той же моделью и по тем же ценам в чипсах, что на сайте. Всего два запроса: отправить фото и забрать результат. В нашем сравнении 18 ИИ-сервисов увеличения фото в октябре 2026 года модель заняла первое место и оказалась самой дешёвой среди лидеров.
На этой странице
Быстрый старт
Создайте ключ на странице аккаунта, сохраните его в переменной окружения MEGAPOTATO_API_KEY и выполните:
# 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://…", …}import os, sys, time, requests
API = "https://megapotato.app/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['MEGAPOTATO_API_KEY']}"}
def call(method, path, headers=None, **kwargs):
"""Один вызов API. Повторяет запросы при временных ошибках (429, 5xx, сеть), при остальных останавливается."""
for attempt in range(8):
try:
r = requests.request(method, f"{API}{path}", headers={**HEADERS, **(headers or {})}, timeout=70, **kwargs)
except (requests.ConnectionError, requests.Timeout):
time.sleep(2 ** attempt)
continue
if r.status_code == 429 or r.status_code >= 500:
time.sleep(float(r.headers.get("Retry-After", 2 ** attempt)))
continue
if not r.ok: # другие 4xx: исправьте запрос, повтор не поможет
err = r.json()["error"]
sys.exit(f"{r.status_code} {err['type']}: {err['message']}")
return r.json()
sys.exit("gave up after repeated temporary errors")
# Байты, а не открытый файл: каждая попытка должна заново отправлять фото целиком.
photo = open("photo.jpg", "rb").read()
job = call("POST", "/upscale", headers={"Idempotency-Key": "photo-001"},
files={"file": ("photo.jpg", photo)}, data={"upscale": "4"})
# Запросите задание хотя бы раз: повторная загрузка может вернуть уже завершённое задание, а result_url / error есть только в GET.
while True:
job = call("GET", f"/jobs/{job['id']}", params={"wait": 55})
if job["status"] in ("completed", "failed"):
break
if job["status"] == "completed":
result = requests.get(job["result_url"], timeout=120)
result.raise_for_status()
open("photo_x4.png", "wb").write(result.content)
else:
print(job["error"])// Сохраните как upscale.mjs и запустите с Node 18+: node upscale.mjs
import { readFile } from "node:fs/promises"
const API = "https://megapotato.app/v1"
const headers = { Authorization: `Bearer ${process.env.MEGAPOTATO_API_KEY}` }
const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
// Один вызов API. Повторяет запросы при временных ошибках (429, 5xx, сеть), при остальных останавливается.
async function call(path, init = {}) {
for (let attempt = 0; attempt < 8; attempt++) {
let res
try {
res = await fetch(`${API}${path}`, { ...init, headers: { ...headers, ...init.headers } })
} catch {
await sleep(2 ** attempt * 1000) // ошибка сети: повторить попытку
continue
}
if (res.status === 429 || res.status >= 500) {
await sleep(Number(res.headers.get("retry-after") ?? 2 ** attempt) * 1000)
continue
}
const body = await res.json()
if (!res.ok) throw new Error(`${res.status} ${body.error.type}: ${body.error.message}`)
return body
}
throw new Error("gave up after repeated temporary errors")
}
const form = new FormData()
form.append("file", new Blob([await readFile("photo.jpg")]), "photo.jpg")
form.append("upscale", "4")
const { id } = await call("/upscale", { method: "POST", headers: { "Idempotency-Key": "photo-001" }, body: form })
// Запросите задание хотя бы раз: повторная загрузка может вернуть уже завершённое задание, а result_url / error есть только в GET.
let job
do {
job = await call(`/jobs/${id}?wait=55`)
} while (job.status !== "completed" && job.status !== "failed")
console.log(job.status === "completed" ? job.result_url : job.error)Попробовать без ключа
Без аккаунта и ключа: отправьте фото на /v1/try и опрашивайте /v1/try/{id}. Это настоящая обработка той же моделью. Поле cost_chips показывает стоимость с ключом, но чипсы не списываются. Пробные задания идут после всех заданий с ключом, поэтому при высокой нагрузке ожидание может быть дольше. Пробный режим ограничен бюджетом: 429 означает, что нужно подождать указанное в Retry-After время или получить ключ, а 403 — что режим закрыт. Сейчас недоступно. Используйте тестовый ключ или ключ API со страницы аккаунта.
# 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
Отправьте исходный размер и масштаб, получите цену. Фото не загружается, чипсы не списываются.
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. Для больших фото выбирайте меньший масштаб.
{"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 — дополнительных действий не нужно.
{
"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 так и не появился.
Ошибки
У всех ошибок одинаковая структура:
{"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.
| HTTP | type | Когда возникает |
|---|---|---|
| 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.
Спецификация, примеры, узел
- Спецификация OpenAPI 3.1 — машиночитаемая спецификация API /v1
- Документация в Markdown — тот же справочник в виде обычного текста — для инструментов и ассистентов
- Примеры кода на GitHub — готовые примеры для curl, Python и Node.js
- Узел ComfyUI — тот же API в виде узла в ComfyUI Manager (исходный код на GitHub: MegaPotato-AI/comfyui-megapotato)
- Сравнение 18 ИИ-сервисов увеличения фото — сравнение модели с другими и открытые данные (CC BY 4.0)
- llms.txt — сайт на одной странице для языковых моделей; полный текст — в /llms-full.txt