MegaPotato API
サイトと同じモデル、同じポテチ料金で、コードから写真を拡大できます。写真を送信し、結果を取得する2回のリクエストだけ。2026年10月に実施した18種のAI画像拡大ツール比較では1位となり、上位ツールの中で最安値でした。
クイックスタート
アカウントページでキーを作成し、環境変数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を1回呼び出します。再試行で成功する可能性のあるエラー(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"})
# ジョブは必ず1回以上取得。再試行したアップロードはすでに完了している場合があり、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を1回呼び出します。再試行で成功する可能性のあるエラー(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 })
// ジョブは必ず1回以上取得。再試行したアップロードはすでに完了している場合があり、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=trueの指定にかかわらず、jpeg_statusは常にreadyです。同じIdempotency-Keyと写真で再試行すると同じジョブIDが返ります。別の写真に同じキーを使って拒否される(422)のは本番キーのみです。準備ができたら本番キーに切り替えてください。初めてポテチパックを購入すると、本番キーを作成できます。
認証
すべてのリクエストでAuthorizationヘッダーにBearer mp_live_…の形式でキーを送信してください。キーが表示されるのは作成時の1回だけで、当社はハッシュのみを保存します。キーはサーバーに保管し、モバイルアプリ、ウェブページ、リポジトリには含めないでください。漏えいした場合はアカウントページで失効させると、すぐに使えなくなります。
料金を確認 — 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
マルチパートフォームでfile(PNG、JPG、WEBP、HEIC、最大40MB)とupscaleを送信します。倍率は1(精細化、同じサイズ)、2、4、8から選べます。入力画像の長辺は最大6 000px、仕上がりは最大16 400pxです。大きな写真は倍率を下げてください。
{"id": "6f6f4c1e-…", "status": "queued", "upscale": 4, "cost_chips": 2}cost_chipsの分はすぐに残高から確保され、処理の完了時に消費されます。処理が失敗すると、自動で返還されます。
任意でjpeg=trueを指定すると、PNGに加えてフルサイズのJPEG(品質92、クロマサブサンプリングなし)を追加料金なしで取得できます。可逆圧縮の16K PNGは数百MBになることがありますが、同じ画像のJPEGは通常、その数分の1程度です。ジョブにはresult_jpeg_urlとjpeg_statusが含まれます。同じIdempotency-Keyを別の写真や異なるupscale、jpegの値で再利用すると422になります。
結果を取得 — GET /v1/jobs/{id}
?wait=55を付けると、サーバーはジョブが完了するか55秒が経過するか、いずれか早い時点までリクエストを保持してから応答します。通常は1回の呼び出しで完了まで待てます。
ほとんどの写真は数秒で完成します。利用が増えると処理能力を追加するため、その直後のリクエストは数分かかる場合があります。その後は通常の速度で処理されます。特別な対応は必要ありません。?wait=55でポーリングを続けてください。
{
"id": "6f6f4c1e-…",
"status": "completed", // queued → running → completed | failed
"result_url": "https://…", // PNG。有効期限は約1時間、認証ヘッダー不要
"error": null, // 失敗時の理由。「your chips were refunded」を含みます
"upscale": 4,
"created_at": "2026-09-15T10:00:00Z",
"eta_seconds": null, // 待機中や処理中の推定時間
"result_jpeg_url": "https://…", // jpeg=trueの場合:フルサイズのJPEG。result_urlと同じ仕様
"jpeg_status": "ready" // jpeg=true未指定ならnull。pending → ready | unavailable
}ジョブを再取得すると、新しいresult_urlが返ります。処理結果の保存期間は90日間です。
jpeg_statusは待機中や処理中にはpending、result_jpeg_urlの設定後はreadyになります。JPEGなしで完了した場合(PNGは提供されます)、失敗した場合、期限切れの場合はunavailableです。jpeg=trueを指定しなければ、両フィールドはnullになります。テストキーは例外で、両URLにサンプル画像が入り、jpeg_statusは常にreadyです。
ジョブがcompletedでも、JPEGのアップロード中はpendingの場合があります。通常は数秒、まれに約1時間かかります。result_urlはすでに使えます。再度ポーリングするとresult_jpeg_urlが返ります(取得できない場合はunavailableになります)。
エラー
すべてのエラーは次の形式で返ります。
{"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_errorupscaleまたはjpegの値が不正、fileが未指定、または異なる写真・upscale・jpegでIdempotency-Keyを再利用しています。
- 429・rate_limit_errorリクエスト数、または同時処理中の写真数が上限を超えています。Retry-Afterに従ってください。
- 422・content_not_allowed自動コンテンツチェックにより画像がブロックされました(利用規約をご覧ください)。ポテチは消費されていません。
- 429・spend_limit_reached今日のAPI使用上限に達しました。UTCの00:00にリセットされます。
- 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の値が不正、fileが未指定、または異なる写真・upscale・jpegでIdempotency-Keyを再利用しています。 |
| 429 | rate_limit_error | リクエスト数、または同時処理中の写真数が上限を超えています。Retry-Afterに従ってください。 |
| 422 | content_not_allowed | 自動コンテンツチェックにより画像がブロックされました(利用規約をご覧ください)。ポテチは消費されていません。 |
| 429 | spend_limit_reached | 今日のAPI使用上限に達しました。UTCの00:00にリセットされます。 |
| 500 | server_error | サーバー側のエラーです。アップロードの場合は同じIdempotency-Keyで再試行してください。 |
| 503 | service_unavailable | 現在、画像を受け付けられません。ポテチは消費されていません。Retry-Afterの時間が過ぎてから再試行してください。 |
上限
- アカウントごとに同時処理は最大10枚です。上限を超えるアップロードには
429が返り、ポテチは消費されません。 - キーごとに1分間に最大100回アップロードできます。状況確認のリクエストには、より高い上限が設けられています。
- キーが漏えいしても残高を使い切られないよう、APIには1日(UTC)あたりの使用上限があります。標準は1日5 000ポテチです。アカウントページで、より低い上限を設定できます。
料金
同じ写真と倍率なら、APIの料金はサイトと同じです。ポテチ残高も共通です。料金は仕上がりのサイズに応じて増え、1 MPの写真を×4にする場合は約2ポテチ、12 MPのスマホ写真を×2にする場合は約5ポテチです。1ポテチの価格はパックによって$0.033–0.05です。どのサイズでも/v1/quoteで料金を確認でき、失敗時はポテチが自動で返還されます。ポテチは料金ページから購入でき、有効期限はありません。
再試行
- アップロードには必ず
Idempotency-Key(写真ごとに固有の値、最大128文字)を付けてください。同じキーで再送すると同じジョブが返り、ポテチの消費は1回だけです。タイムアウトしても安心して再試行できます。 429の場合はRetry-Afterに従って待ってください。5xxや通信エラーの場合は、間隔を延ばしながら再試行してください(1秒、2秒、4秒…)。ほかの4xxエラーは再試行しても解決しないため、リクエストを修正してください。- 毎秒リクエストする代わりに、
?wait=55でポーリングしてください。
ベータ版とバージョン管理
APIはパブリックベータ版です。現時点で稼働率の保証はなく、予定されている変更はメールでお知らせします。/v1内の変更は新しいフィールドやエラー種別の追加のみなので、未知のフィールドは無視してください。既存の連携が動かなくなる変更は/v2として公開し、少なくとも90日前にお知らせします。
利用ルール
処理結果の権利はお客様にあります。APIは処理する権利のある画像にのみお使いください。違法なコンテンツ、未成年者に関する性的なコンテンツ、本人の同意のない私的な性的画像には使えません。これらのルールや利用規約に違反したアカウントは停止されます。不正利用の通報はabuse@megapotato.app、ご質問はsupport@megapotato.appまでお寄せください。
仕様・サンプル・ノード
- OpenAPI 3.1仕様 — /v1 APIの機械可読な仕様
- このドキュメントのMarkdown版 — ツールやアシスタント向けに同じリファレンスをプレーンテキストで提供
- GitHubのサンプルコード — そのまま実行できるcurl、Python、Node.jsの例
- ComfyUIノード — 同じAPIをComfyUI Managerのノードとして利用(GitHubのソース:MegaPotato-AI/comfyui-megapotato)
- 18種のAI画像拡大ツール比較 — モデルの比較結果と公開データ(CC BY 4.0)
- llms.txt — 言語モデル向けのサイト概要を1ページに。全文は/llms-full.txtに掲載