REST API

API Dokümantasyonu

Basit bir REST API ile manga çevirisini uygulamanıza entegre edin.

Hızlı Başlangıç

Bir API anahtarı alın

Kontrol paneli ayarlarınızdan bir anahtar oluşturun. Anahtarlar mg_live_ veya mg_test_ ile başlar.

Bir görsel yükleyin

Önceden imzalanmış bir URL isteyin, ardından görsel baytlarını ona PUT yapın.

Bir iş oluşturun

Çeviriyi başlatmak için yükleme anahtarını gönderin. İş tamamlanana kadar yoklayın.

Kimlik Doğrulama

API anahtarınızı Authorization başlığında Bearer token olarak ekleyin.

Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Canlı mod anahtarları (mg_live_) gerçek kredilerinizi kullanır.
Test modu anahtarları (mg_test_) mock GPU kullanır — kredi tüketilmez.

Endpoint Referansı

Temel URL: https://api.mangagloss.com

POST/v1/uploads/presignÖnceden imzalanmış yükleme URL'si alın

R2 depolamasına bir görsel yüklemek için önceden imzalanmış bir URL döndürür.

Request

{
  "count": 1
}

Response

{
  "uploads": [
    { "key": "abc123...", "url": "https://..." }
  ]
}

PUT/v1/uploads/direct/:keyGörsel yükleyin

Ham görsel baytlarını önceden imzalanmış URL'ye yükleyin. Başlıkta görsel içerik türünü gönderin.

Request

Raw image bytes (Content-Type: image/png or image/jpeg)

Response

{ "ok": true }

POST/v1/jobsÇeviri işi oluşturun

Yüklenen görseller için bir çeviri işi başlatın. Kredi gerektirir (sayfa başına 1).

Request

{
  "pages": ["abc123..."],
  "source_lang": "JPN",
  "target_lang": "ENG",
  "engine": "premium"
}

Response

{ "job_id": "x7k9m2..." }

GET/v1/jobs/:idİş durumunu alın

Durum completed veya failed olana kadar bu endpoint'i yoklayın. Sonuçlar çevrilmiş görsel URL'lerini ve metin bölgelerini içerir.

Response

{
  "id": "x7k9m2...",
  "status": "completed",
  "pages": [
    {
      "id": "p1...",
      "status": "completed",
      "output_url": "https://...",
      "regions": [...]
    }
  ]
}

Kod Örnekleri

Seçtiğiniz dilde tam tek sayfa çeviri akışı.

# 1. Get a presigned upload URL
PRESIGN=$(curl -s -X POST https://api.mangagloss.com/v1/uploads/presign \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 1}')

KEY=$(echo $PRESIGN | jq -r '.uploads[0].key')
URL=$(echo $PRESIGN | jq -r '.uploads[0].url')

# 2. Upload the image
curl -s -X PUT "$URL" \
  -H "Content-Type: image/png" \
  --data-binary @page.png

# 3. Create a translation job
JOB=$(curl -s -X POST https://api.mangagloss.com/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pages\": [\"$KEY\"], \"source_lang\": \"JPN\", \"target_lang\": \"ENG\", \"engine\": \"premium\"}")

JOB_ID=$(echo $JOB | jq -r '.job_id')

# 4. Poll until complete
curl -s https://api.mangagloss.com/v1/jobs/$JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Hız Limitleri ve Hatalar

API anahtarları dakikada 30 istek ile sınırlandırılmıştır. Krediler gerçek korkuluktur.

Durum	Anlam
`200`	Başarılı
`400`	Kötü istek — parametrelerinizi kontrol edin
`401`	Yetkilendirilmemiş — eksik veya geçersiz API anahtarı
`402`	Yetersiz kredi
`404`	Kaynak bulunamadı
`429`	Hız sınırlandı — bekleyin ve tekrar deneyin
`500`	Sunucu hatası — geri çekilme ile tekrar deneyin

Entegre etmeye hazır mısınız?

Bir API anahtarı oluşturun ve programatik olarak manga çevirmeye başlayın.

Bir API anahtarı oluşturun