GELİŞTİRİCİ API'Sİ · HERKESE AÇIK BETA

MegaPotato API

Sitedekiyle aynı model ve cips fiyatlarıyla kendi kodundan fotoğraf büyüt. İki istek yeterli: fotoğrafı gönder, sonra sonucu al. Modelimiz Ekim 2026'daki 18 yapay zekâ büyütme aracı karşılaştırmamızda birinci oldu ve liderler arasında en uygun fiyatı sundu.

Bu sayfada

Hızlı başlangıç

Hesap sayfanda bir anahtar oluştur, MEGAPOTATO_API_KEY ortam değişkenine ekle ve çalıştır:

shell
# 1. Fotoğraf gönder
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. Bekle (sunucu isteği en fazla 55 sn açık tutar)
curl "https://megapotato.app/v1/jobs/6f6f4c1e-…?wait=55" \
  -H "Authorization: Bearer $MEGAPOTATO_API_KEY"
# → {"status": "completed", "result_url": "https://…", …}

Anahtarsız dene

Hesap ve anahtar gerekmez: /v1/try adresine fotoğraf gönder, ardından /v1/try/{id} adresini sorgula. Aynı modelde gerçek bir işlem çalışır; cost_chips anahtarla ödeyeceğin tutardır, ancak ücret alınmaz. Deneme işlemleri tüm anahtarlı işlemlerin arkasında sıraya girer, bu yüzden yoğunlukta daha uzun bekleyebilir. Denemelerin bütçesi sınırlıdır: 429 alırsan Retry-After süresini bekle veya anahtar al; 403 denemenin kapalı olduğu anlamına gelir. Şu an kapalı. Hesap sayfandan bir test anahtarı veya API anahtarı kullan.

shell
# 1. Fotoğraf gönder (hesap ve anahtar gerekmez)
curl https://megapotato.app/v1/try -F file=@photo.jpg -F upscale=4
# → {"id": "6f6f4c1e-…", "status": "queued", "upscale": 4, "cost_chips": 2}

# 2. Bekle (sunucu isteği en fazla 55 sn açık tutar)
curl "https://megapotato.app/v1/try/6f6f4c1e-…?wait=55"
# → {"status": "completed", "result_url": "https://…", …}

Test anahtarları

Cips almadan entegrasyonunu hazırlamak mı istiyorsun? Giriş yapan herkes hesap sayfasında test anahtarı (mp_test_…) oluşturabilir. Tüm akıştan geçersin: yüklemeler canlı anahtardaki gibi kontrol edilir ve fiyatlandırılır. Ancak işlem çalışmaz, ücret alınmaz. Her işlem completed durumuyla döner; result_url ve result_jpeg_url örnek görseli içerir. jpeg=true göndersen de göndermesen de jpeg_status hep ready olur. Aynı Idempotency-Key ve fotoğrafla tekrar denediğinde aynı işlem kimliği döner. Aynı anahtarı farklı fotoğraf için kullanmak yalnızca canlı anahtarlarda reddedilir (422). Hazır olduğunda canlı anahtara geç. İlk cips paketinle canlı anahtarlar açılır.

Kimlik doğrulama

Her istekte anahtarını Authorization başlığında gönder: Bearer mp_live_…. Anahtarlar oluşturulurken yalnızca bir kez gösterilir; biz sadece karmasını saklarız. Sunucunda tut, asla mobil uygulamaya, web sayfasına veya kod deposuna koyma. Bir anahtar sızarsa hesap sayfandan iptal et; anında çalışmayı bırakır.

Fiyatı öğren — POST /v1/quote

Girdi boyutunu ve büyütme oranını gönder, fiyatı al. Dosya yüklenmez, ücret alınmaz.

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}

Fotoğraf büyüt — POST /v1/upscale

Çok parçalı formda file (PNG, JPG, WEBP ve HEIC, en fazla 40 MB) ve upscale gönder: 1 (Detay, aynı boyut), 2, 4 veya 8. Girdinin uzun kenarı en fazla 6 000 px, sonucunki ise 16 400 px olabilir. Büyük fotoğraflar için daha düşük bir oran seç.

response
{"id": "6f6f4c1e-…", "status": "queued", "upscale": 4, "cost_chips": 2}

cost_chips tutarı bakiyenden hemen ayrılır, fotoğraf tamamlanınca tahsil edilir. İşlem başarısız olursa cipsler otomatik olarak iade edilir.

İsteğe bağlı jpeg=true, PNG'nin yanına ek ücret olmadan tam boyutlu JPEG ekler (kalite 92, renk alt örneklemesi yok). Kayıpsız bir 16K PNG birkaç yüz MB olabilir; aynı sonucun JPEG dosyası genellikle bunun çok küçük bir kısmıdır. İşlem bu durumda result_jpeg_url ve jpeg_status alanlarını içerir. Aynı Idempotency-Key farklı fotoğraf, upscale veya jpeg değeriyle kullanılırsa 422 döner.

Sonucu al — GET /v1/jobs/{id}

?wait=55 eklediğinde sunucu, işlem bitene veya 55 saniye geçene kadar isteği açık tutar. Genellikle tek çağrı tüm işlem için yeterlidir.

Çoğu fotoğraf saniyeler içinde hazır olur. Talep artınca kapasite ekleriz; bundan sonraki ilk istekler birkaç dakika sürebilir, ardından her şey tam hızda çalışır. ?wait=55 ile sorgulamaya devam et; ek bir şey yapman gerekmez.

response
{
  "id": "6f6f4c1e-…",
  "status": "completed",          // queued → running → completed | failed
  "result_url": "https://…",      // PNG; yaklaşık bir saat geçerli bağlantı, kimlik doğrulama başlığı gerekmez
  "error": null,                  // başarısız olduğunda nedeni ve “cipslerin iade edildi” mesajı
  "upscale": 4,
  "created_at": "2026-09-15T10:00:00Z",
  "eta_seconds": null,            // sıradayken veya çalışırken tahmini süre
  "result_jpeg_url": "https://…", // jpeg=true ile: tam boyutlu JPEG, result_url ile aynı kurallar
  "jpeg_status": "ready"          // jpeg=true olmadan null; pending → ready | unavailable
}

Yeni bir result_url almak için işlemi tekrar sorgula. Sonuçlar 90 gün erişilebilir kalır.

jpeg_status, işlem sırada veya çalışırken pending, result_jpeg_url hazır olduğunda ready olur. İşlem JPEG olmadan tamamlanırsa (PNG yine sunulur), başarısız olursa veya süresi dolarsa unavailable olur. jpeg=true yoksa iki alan da null olur. Test anahtarları istisnadır: her iki URL de örnek görseli içerir ve jpeg_status hep ready olur.

completed durumundaki bir işlemde JPEG yüklenirken durum hâlâ pending olabilir. Genellikle saniyeler sürer, nadiren yaklaşık bir saati bulabilir. result_url zaten çalışır; tekrar sorguladığında result_jpeg_url gelir (hiç oluşmazsa unavailable döner).

Hatalar

Tüm hatalar aynı yapıdadır:

response
{"error": {"type": "insufficient_credits", "message": "insufficient chips: available 0, needed 2"}}
  • 400 · invalid_request_error
    Görsel çözümlenemiyor veya boyutu sınırları aşıyor.
  • 401 · authentication_error
    Anahtar eksik, yanlış veya iptal edilmiş.
  • 402 · insufficient_credits
    Bu fotoğraf için cips yetersiz. Gereken miktar mesajda belirtilir.
  • 404 · invalid_request_error
    Böyle bir işlem yok veya sana ait değil.
  • 413 · invalid_request_error
    Dosya, yükleme sınırından büyük.
  • 415 · invalid_request_error
    Görsel formatı desteklenmiyor.
  • 422 · invalid_request_error
    upscale veya jpeg değeri hatalı, dosya eksik ya da Idempotency-Key farklı bir fotoğraf, upscale veya jpeg değeriyle yeniden kullanılmış.
  • 429 · rate_limit_error
    Çok fazla istek veya aynı anda işlenen çok fazla fotoğraf var. Retry-After süresine uy.
  • 422 · content_not_allowed
    Otomatik içerik kontrolümüz görseli engelledi (Koşullara bak). Ücret alınmadı.
  • 429 · spend_limit_reached
    Bugünün API harcama limitine ulaşıldı. 00:00 UTC'de sıfırlanır.
  • 500 · server_error
    Hata bizde. Tekrar dene; yüklemelerde aynı Idempotency-Key değerini kullan.
  • 503 · service_unavailable
    Şu an görsel kabul edemiyoruz. Ücret alınmadı; Retry-After süresinden sonra tekrar dene.

Sınırlar

  • Hesap başına aynı anda en fazla 10 fotoğraf işlenebilir. Sınır aşılırsa yeni yükleme 429 döndürür ve ücret alınmaz.
  • Anahtar başına dakikada en fazla 100 yükleme yapılabilir. Durum sorgularının sınırı daha yüksektir.
  • Sızan bir anahtarın bakiyeni tüketmesini önlemek için API'de UTC gününe göre günlük harcama limiti vardır. Varsayılan limit Günde 5 000 cips. Hesap sayfandan daha düşük bir limit belirleyebilirsin.

Fiyatlar

API'de aynı fotoğraf ve büyütme oranı, sitedekiyle aynı tutardadır ve aynı cips bakiyesinden ödenir. Fiyat sonucun boyutuyla artar: 1 MP fotoğrafı ×4 büyütmek yaklaşık 2 cips, 12 MP telefon fotoğrafını ×2 büyütmek yaklaşık 5 cips tutar. Pakete göre cips başına fiyat $0.033–0.05 olur. Her boyutun fiyatını /v1/quote ile öğrenebilirsin; başarısız işlemlerin cipsleri otomatik iade edilir. Fiyatlar sayfasından cips alabilirsin; süreleri dolmaz.

Yeniden denemeler

  • Yüklemelerde her zaman Idempotency-Key gönder (en fazla 128 karakter, her fotoğraf için benzersiz). Aynı anahtarla isteği tekrarlarsan aynı işlem döner ve ücret yalnızca bir kez alınır. Zaman aşımından sonra güvenle tekrar deneyebilirsin.
  • 429 için Retry-After süresini bekle. 5xx veya bağlantı hatasında bekleme süresini artırarak tekrar dene (1 sn, 2 sn, 4 sn…). Diğer 4xx hatalarında yeniden denemek işe yaramaz; isteği düzelt.
  • Her saniye çağrı yapmak yerine ?wait=55 ile sorgula.

Beta ve sürümleme

API herkese açık beta aşamasında. Henüz kesintisiz çalışma garantisi yok; planlanan değişiklikleri e-postayla bildiririz. /v1 kapsamında yalnızca yeni alanlar ve hata türleri gibi eklemeler yaparız. Tanımadığın alanları yok say. Entegrasyonu bozabilecek değişiklikler, en az 90 gün önceden duyurularak /v2 olarak yayımlanır.

Kabul edilebilir kullanım

Sonuçlar sana aittir. API'yi yalnızca işleme hakkın olan görseller için kullan. API'yi yasa dışı içerik veya reşit olmayanları içeren cinsel içerik için ya da kişilerin mahrem görsellerini rızaları olmadan işlemek için kullanamazsın. Bu kuralları ya da Koşulları ihlal eden hesaplar engellenir. Kötüye kullanımı abuse@megapotato.app adresine bildir; soruların için support@megapotato.app adresine yaz.

API anahtarını al

Tanım, örnekler, düğüm