API DEVELOPER Β· BETA PUBLIK

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:

shell
# 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://…", …}

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.

shell
# 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.

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}

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.

response
{"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.

response
{
  "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:

response
{"error": {"type": "insufficient_credits", "message": "insufficient chips: available 0, needed 2"}}
  • 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 429 tanpa 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 sesuai Retry-After. Saat 5xx atau jaringan bermasalah, coba lagi dengan jeda yang makin lama (1 dtk, 2 dtk, 4 dtk…). Error 4xx lainnya 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.

Dapatkan kunci API kamu

Spesifikasi, contoh, node