API MegaPotato
Perbesar foto lewat kodemu sendiri dengan model dan tarif keripik yang sama seperti di situs. Dua permintaan: kirim foto, lalu ambil hasilnya. Dalam uji banding kami terhadap 18 alat pembesar gambar AI pada Oktober 2026, model ini meraih peringkat pertama dan paling murah di antara yang terbaik.
Di halaman ini
Mulai cepat
Buat kunci di halaman akunmu, masukkan ke variabel lingkungan MEGAPOTATO_API_KEY, lalu jalankan:
# 1. Kirim foto
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. Tunggu hasilnya (server menahan permintaan hingga 55 dtk)
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):
"""Satu panggilan API. Mengulang yang bisa berhasil nanti (429, 5xx, jaringan), berhenti untuk yang lain."""
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 lainnya: perbaiki permintaan, mencoba ulang tidak akan membantu
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")
# Byte, bukan file terbuka: setiap percobaan ulang harus mengirim ulang seluruh foto.
photo = open("photo.jpg", "rb").read()
job = call("POST", "/upscale", headers={"Idempotency-Key": "photo-001"},
files={"file": ("photo.jpg", photo)}, data={"upscale": "4"})
# Selalu baca tugas minimal sekali: unggahan yang diulang mungkin sudah selesai, dan hanya GET yang menyertakan result_url / error.
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"])// Simpan sebagai upscale.mjs dan jalankan dengan 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))
// Satu panggilan API. Mengulang yang bisa berhasil nanti (429, 5xx, jaringan), berhenti untuk yang lain.
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) // jaringan bermasalah: coba lagi
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 })
// Selalu baca tugas minimal sekali: unggahan yang diulang mungkin sudah selesai, dan hanya GET yang menyertakan result_url / error.
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)Coba tanpa kunci
Tanpa akun dan kunci: kirim foto ke /v1/try lalu lakukan polling ke /v1/try/{id}. Foto benar-benar diproses dengan model yang sama; cost_chips adalah biaya jika memakai kunci, dan kamu tidak dikenai biaya. Tugas percobaan mengantre di belakang semua tugas berkunci, jadi bisa menunggu lebih lama saat layanan sibuk. Percobaan punya batas anggaran, jadi 429 berarti tunggu sesuai Retry-After atau buat kunci, dan 403 berarti percobaan ditutup. Sedang ditutup; gunakan kunci uji coba atau kunci API dari halaman akunmu.
# 1. Kirim foto (tanpa akun, tanpa kunci)
curl https://megapotato.app/v1/try -F file=@photo.jpg -F upscale=4
# β {"id": "6f6f4c1e-β¦", "status": "queued", "upscale": 4, "cost_chips": 2}
# 2. Tunggu hasilnya (server menahan permintaan hingga 55 dtk)
curl "https://megapotato.app/v1/try/6f6f4c1e-β¦?wait=55"
# β {"status": "completed", "result_url": "https://β¦", β¦}Kunci uji coba
Mau menyiapkan integrasi sebelum membeli keripik? Setiap akun yang sudah masuk bisa membuat kunci uji coba (mp_test_β¦) di halaman akun. Kunci ini mengikuti seluruh alur β unggahan dicek dan dihitung biayanya persis seperti kunci produksi β tetapi tidak ada pemrosesan atau biaya: setiap tugas mengembalikan completed dengan gambar contoh di result_url dan result_jpeg_url, serta jpeg_status selalu ready, baik jpeg=true dikirim maupun tidak. Percobaan ulang dengan Idempotency-Key dan foto yang sama mengembalikan ID tugas yang sama; memakai ulang kunci untuk foto berbeda hanya ditolak (422) pada kunci produksi. Beralihlah ke kunci produksi saat siap. Kunci produksi tersedia setelah kamu membeli paket keripik pertama.
Autentikasi
Kirim kuncimu di setiap permintaan lewat header Authorization: Bearer mp_live_β¦. Kunci hanya ditampilkan sekali saat dibuat; kami hanya menyimpan hash. Simpan di servermu β jangan di aplikasi seluler, halaman web, atau repositori. Jika kunci bocor, cabut di halaman akun; kunci langsung berhenti berfungsi.
Cek harga β POST /v1/quote
Kirim ukuran input dan faktor perbesaran untuk mendapat harga. Tidak ada unggahan atau biaya.
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}Perbesar foto β POST /v1/upscale
Form multipart dengan file (PNG, JPG, WEBP, dan HEIC, maksimal 40 MB) dan upscale: 1 (perjelas, ukuran tetap), 2, 4, atau 8. Sisi terpanjang input maksimal 6Β 000 px, dan hasil maksimal 16Β 400 px β pilih faktor lebih kecil untuk foto besar.
{"id": "6f6f4c1e-β¦", "status": "queued", "upscale": 4, "cost_chips": 2}cost_chips langsung ditahan dari saldomu dan dipotong setelah foto selesai. Jika pemrosesan gagal, keripik otomatis dikembalikan.
Opsi jpeg=true menambahkan hasil JPEG ukuran penuh (kualitas 92, tanpa chroma subsampling) di samping PNG, tanpa biaya tambahan. PNG lossless 16K bisa berukuran ratusan MB, sedangkan JPEG dari hasil yang sama biasanya jauh lebih kecil. Tugas akan menyertakan result_jpeg_url dan jpeg_status. Idempotency-Key yang dipakai ulang dengan foto, upscale, atau jpeg berbeda menghasilkan 422.
Ambil hasil β GET /v1/jobs/{id}
Tambahkan ?wait=55 agar server menahan permintaan hingga tugas selesai atau 55 detik berlalu, mana yang lebih dulu β biasanya satu panggilan cukup untuk seluruh tugas.
Sebagian besar foto selesai dalam hitungan detik. Saat permintaan meningkat, kami menambah kapasitas, dan beberapa permintaan awal bisa memakan waktu beberapa menit β setelah itu semuanya berjalan dengan kecepatan penuh. Terus lakukan polling dengan ?wait=55; tidak perlu penanganan khusus.
{
"id": "6f6f4c1e-β¦",
"status": "completed", // queued β running β completed | failed
"result_url": "https://β¦", // PNG; tautan berlaku sekitar satu jam, tidak perlu header autentikasi
"error": null, // alasan saat gagal, dengan "keripik kamu sudah dikembalikan"
"upscale": 4,
"created_at": "2026-09-15T10:00:00Z",
"eta_seconds": null, // perkiraan saat mengantre atau berjalan
"result_jpeg_url": "https://β¦", // dengan jpeg=true: JPEG ukuran penuh, aturan sama seperti result_url
"jpeg_status": "ready" // null tanpa jpeg=true; pending β ready | unavailable
}Ambil lagi data tugas untuk mendapat result_url baru. Hasil tersedia selama 90 hari.
jpeg_status bernilai pending saat tugas mengantre atau berjalan, ready setelah result_jpeg_url tersedia, dan unavailable saat tugas selesai tanpa JPEG (PNG tetap diberikan), gagal, atau kedaluwarsa. Tanpa jpeg=true, kedua kolom bernilai null. Kunci uji coba dikecualikan: kedua URL berisi gambar contoh dan jpeg_status selalu ready.
Tugas completed masih bisa menampilkan pending selama JPEG diunggah β biasanya beberapa detik, terkadang hingga sekitar satu jam: result_url sudah bisa dipakai, dan polling berikutnya memberikan result_jpeg_url (atau unavailable jika JPEG tidak tersedia).
Error
Semua error memiliki format yang sama:
{"error": {"type": "insufficient_credits", "message": "insufficient chips: available 0, needed 2"}}- 400 Β· invalid_request_errorGambar tidak bisa didekode, atau ukurannya melebihi batas.
- 401 Β· authentication_errorKunci tidak ada, salah, atau sudah dicabut.
- 402 Β· insufficient_creditsKeripik tidak cukup untuk foto ini β pesan menyebutkan jumlah yang dibutuhkan.
- 404 Β· invalid_request_errorTugas tidak ditemukan (atau bukan milikmu).
- 413 Β· invalid_request_errorFile melebihi batas unggahan.
- 415 Β· invalid_request_errorFormat gambar tidak didukung.
- 422 Β· invalid_request_errorNilai upscale atau jpeg salah, file tidak ada, atau Idempotency-Key dipakai ulang untuk foto, upscale, atau jpeg berbeda.
- 429 Β· rate_limit_errorTerlalu banyak permintaan, atau terlalu banyak foto diproses sekaligus. Ikuti Retry-After.
- 422 Β· content_not_allowedPemeriksaan konten otomatis kami memblokir gambar ini (lihat Ketentuan). Tidak ada biaya.
- 429 Β· spend_limit_reachedBatas pemakaian API hari ini tercapai. Direset pukul 00:00 UTC.
- 500 Β· server_errorKesalahan di pihak kami. Coba lagi β dengan Idempotency-Key yang sama untuk unggahan.
- 503 Β· service_unavailableKami belum bisa menerima gambar. Tidak ada biaya; coba lagi setelah Retry-After.
| HTTP | type | Kapan |
|---|---|---|
| 400 | invalid_request_error | Gambar tidak bisa didekode, atau ukurannya melebihi batas. |
| 401 | authentication_error | Kunci tidak ada, salah, atau sudah dicabut. |
| 402 | insufficient_credits | Keripik tidak cukup untuk foto ini β pesan menyebutkan jumlah yang dibutuhkan. |
| 404 | invalid_request_error | Tugas tidak ditemukan (atau bukan milikmu). |
| 413 | invalid_request_error | File melebihi batas unggahan. |
| 415 | invalid_request_error | Format gambar tidak didukung. |
| 422 | invalid_request_error | Nilai upscale atau jpeg salah, file tidak ada, atau Idempotency-Key dipakai ulang untuk foto, upscale, atau jpeg berbeda. |
| 429 | rate_limit_error | Terlalu banyak permintaan, atau terlalu banyak foto diproses sekaligus. Ikuti Retry-After. |
| 422 | content_not_allowed | Pemeriksaan konten otomatis kami memblokir gambar ini (lihat Ketentuan). Tidak ada biaya. |
| 429 | spend_limit_reached | Batas pemakaian API hari ini tercapai. Direset pukul 00:00 UTC. |
| 500 | server_error | Kesalahan di pihak kami. Coba lagi β dengan Idempotency-Key yang sama untuk unggahan. |
| 503 | service_unavailable | Kami belum bisa menerima gambar. Tidak ada biaya; coba lagi setelah Retry-After. |
Batas
- Maksimal 10 foto diproses sekaligus per akun. Jika terlampaui, unggahan baru mendapat
429tanpa biaya. - Maksimal 100 unggahan per menit per kunci; batas permintaan status lebih longgar.
- Batas pemakaian harian lewat API (hari UTC) mencegah kunci bocor menguras saldo β standarnya 5Β 000 keripik per hari. Kamu bisa mengatur batas lebih rendah di halaman akun.
Harga
Biaya API persis sama dengan situs untuk foto dan faktor yang sama, dibayar dari saldo keripik yang sama. Harga bertambah sesuai ukuran hasil: foto 1 MP di Γ4 sekitar 2 keripik, foto ponsel 12 MP di Γ2 sekitar 5 keripik. Harga per keripik $0.033β0.05, tergantung paket. Cek ukuran apa pun lewat /v1/quote; keripik untuk tugas yang gagal otomatis dikembalikan. Beli keripik di halaman harga; keripik tidak kedaluwarsa.
Percobaan ulang
- Selalu kirim
Idempotency-Key(maksimal 128 karakter, unik per foto) bersama unggahan. Mengulang permintaan dengan kunci yang sama mengembalikan tugas yang sama dan hanya dikenai biaya sekali β jadi aman mencoba lagi setelah timeout. - Saat
429, tunggu sesuaiRetry-After. Saat5xxatau jaringan bermasalah, coba lagi dengan jeda yang makin lama (1 dtk, 2 dtk, 4 dtkβ¦). Error4xxlainnya tidak akan berhasil hanya dengan mencoba lagi β perbaiki permintaannya. - Lakukan polling dengan
?wait=55, jangan memanggil tiap detik.
Beta & versi
API masih dalam beta publik: belum ada jaminan waktu aktif, dan kami akan memberi tahu rencana perubahan lewat email. Di /v1 kami hanya menambahkan hal baru β kolom baru, jenis error baru β jadi abaikan kolom yang tidak dikenal. Perubahan yang bisa merusak integrasi akan dirilis sebagai /v2, dengan pemberitahuan minimal 90 hari sebelumnya.
Penggunaan yang diizinkan
Hasilnya milikmu. Gunakan API hanya untuk gambar yang berhak kamu proses. API tidak boleh dipakai untuk konten ilegal, konten seksual yang melibatkan anak di bawah umur, atau gambar intim seseorang tanpa persetujuannya. Akun yang melanggar aturan ini atau Ketentuan akan diblokir. Laporkan penyalahgunaan ke abuse@megapotato.app; kirim pertanyaan ke support@megapotato.app.
Spesifikasi, contoh, node
- Spesifikasi OpenAPI 3.1 β API /v1 dalam spesifikasi yang bisa dibaca mesin
- Dokumentasi ini dalam Markdown β referensi yang sama dalam teks biasa, untuk alat dan asisten
- Contoh kode di GitHub β curl, Python, dan Node.js, siap dijalankan
- Node ComfyUI β API yang sama sebagai node di ComfyUI Manager (kode sumber di GitHub: MegaPotato-AI/comfyui-megapotato)
- Uji banding 18 alat pembesar gambar AI β perbandingan model dengan data terbuka (CC BY 4.0)
- llms.txt β situs dalam satu halaman untuk model bahasa; /llms-full.txt memuat teks lengkap