開発者向けAPI・パブリックベータ

MegaPotato API

サイトと同じモデル、同じポテチ料金で、コードから写真を拡大できます。写真を送信し、結果を取得する2回のリクエストだけ。2026年10月に実施した18種のAI画像拡大ツール比較では1位となり、上位ツールの中で最安値でした。

目次

クイックスタート

アカウントページでキーを作成し、環境変数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=trueの指定にかかわらず、jpeg_statusは常にreadyです。同じIdempotency-Keyと写真で再試行すると同じジョブIDが返ります。別の写真に同じキーを使って拒否される(422)のは本番キーのみです。準備ができたら本番キーに切り替えてください。初めてポテチパックを購入すると、本番キーを作成できます。

認証

すべてのリクエストでAuthorizationヘッダーにBearer mp_live_…の形式でキーを送信してください。キーが表示されるのは作成時の1回だけで、当社はハッシュのみを保存します。キーはサーバーに保管し、モバイルアプリ、ウェブページ、リポジトリには含めないでください。漏えいした場合はアカウントページで失効させると、すぐに使えなくなります。

料金を確認 — 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

マルチパートフォームでfile(PNG、JPG、WEBP、HEIC、最大40MB)とupscaleを送信します。倍率は1(精細化、同じサイズ)、2、4、8から選べます。入力画像の長辺は最大6 000px、仕上がりは最大16 400pxです。大きな写真は倍率を下げてください。

response
{"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でポーリングを続けてください。

response
{
  "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になります)。

エラー

すべてのエラーは次の形式で返ります。

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の値が不正、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までお寄せください。

APIキーを取得

仕様・サンプル・ノード