Loading...
Integrasikan terjemahan manga ke dalam aplikasi Anda dengan REST API yang sederhana.
Buat key dari pengaturan dasbor Anda. Key dimulai dengan mg_live_ atau mg_test_.
Minta presigned URL, lalu PUT byte gambar ke URL tersebut.
Kirim upload key untuk memulai terjemahan. Poll job hingga selesai.
Sertakan API key Anda sebagai Bearer token di header Authorization.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBase URL: https://api.mangagloss.com
/v1/uploads/presignDapatkan presigned upload URLMengembalikan presigned URL untuk mengunggah gambar ke penyimpanan R2.
Request
{
"count": 1
}Response
{
"uploads": [
{ "key": "abc123...", "url": "https://..." }
]
}/v1/uploads/direct/:keyUnggah gambarUnggah byte gambar mentah ke presigned URL. Kirim tipe konten gambar di header.
Request
Raw image bytes (Content-Type: image/png or image/jpeg)Response
{ "ok": true }/v1/jobsBuat translation jobMulai translation job untuk gambar yang diunggah. Memerlukan kredit (1 per halaman).
Request
{
"pages": ["abc123..."],
"source_lang": "JPN",
"target_lang": "ENG",
"engine": "premium"
}Response
{ "job_id": "x7k9m2..." }/v1/jobs/:idDapatkan status jobPoll endpoint ini hingga status completed atau failed. Hasil mencakup URL gambar terjemahan dan region teks.
Response
{
"id": "x7k9m2...",
"status": "completed",
"pages": [
{
"id": "p1...",
"status": "completed",
"output_url": "https://...",
"regions": [...]
}
]
}Alur lengkap terjemahan satu halaman dalam bahasa pilihan Anda.
# 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 key dibatasi hingga 30 permintaan per menit. Kredit adalah pembatas yang sebenarnya.
| Status | Arti |
|---|---|
200 | Berhasil |
400 | Permintaan tidak valid — periksa parameter Anda |
401 | Tidak terotorisasi — API key hilang atau tidak valid |
402 | Kredit tidak cukup |
404 | Resource tidak ditemukan |
429 | Rate limited — tunggu dan coba lagi |
500 | Error server — coba lagi dengan backoff |
Buat API key dan mulai menerjemahkan manga secara programatis.
Buat API key