Loading...
Basit bir REST API ile manga çevirisini uygulamanıza entegre edin.
Kontrol paneli ayarlarınızdan bir anahtar oluşturun. Anahtarlar mg_live_ veya mg_test_ ile başlar.
Önceden imzalanmış bir URL isteyin, ardından görsel baytlarını ona PUT yapın.
Çeviriyi başlatmak için yükleme anahtarını gönderin. İş tamamlanana kadar yoklayın.
API anahtarınızı Authorization başlığında Bearer token olarak ekleyin.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxTemel URL: https://api.mangagloss.com
/v1/uploads/presignÖnceden imzalanmış yükleme URL'si alınR2 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://..." }
]
}/v1/uploads/direct/:keyGörsel yükleyinHam 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 }/v1/jobsÇeviri işi oluşturunYü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..." }/v1/jobs/:idİş durumunu alınDurum 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": [...]
}
]
}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"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 |
Bir API anahtarı oluşturun ve programatik olarak manga çevirmeye başlayın.
Bir API anahtarı oluşturun