Loading...
دمج ترجمة المانغا في تطبيقك باستخدام REST API بسيط.
أنشئ مفتاحاً من إعدادات لوحة التحكم الخاصة بك. تبدأ المفاتيح بـ mg_live_ أو mg_test_.
اطلب URL موقعاً مسبقاً، ثم أرسل بيانات الصورة إليه باستخدام PUT.
أرسل مفتاح الرفع لبدء الترجمة. استعلم عن المهمة حتى تكتمل.
ضمّن مفتاح API الخاص بك كـ Bearer token في رأس Authorization.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxURL الأساسي: https://api.mangagloss.com
/v1/uploads/presignالحصول على URL رفع موقع مسبقاًيُرجع URL موقعاً مسبقاً لرفع صورة إلى مساحة تخزين R2.
Request
{
"count": 1
}Response
{
"uploads": [
{ "key": "abc123...", "url": "https://..." }
]
}/v1/uploads/direct/:keyرفع صورةارفع بيانات الصورة الخام إلى URL الموقع مسبقاً. أرسل نوع محتوى الصورة في الرأس.
Request
Raw image bytes (Content-Type: image/png or image/jpeg)Response
{ "ok": true }/v1/jobsإنشاء مهمة ترجمةابدأ مهمة ترجمة للصور المرفوعة. يتطلب رصيداً (1 لكل صفحة).
Request
{
"pages": ["abc123..."],
"source_lang": "JPN",
"target_lang": "ENG",
"engine": "premium"
}Response
{ "job_id": "x7k9m2..." }/v1/jobs/:idالحصول على حالة المهمةاستعلم عن نقطة النهاية هذه حتى تصبح الحالة مكتملة أو فاشلة. تتضمن النتائج URLs الصور المترجمة ومناطق النص.
Response
{
"id": "x7k9m2...",
"status": "completed",
"pages": [
{
"id": "p1...",
"status": "completed",
"output_url": "https://...",
"regions": [...]
}
]
}سير عمل كامل لترجمة صفحة واحدة بلغة برمجتك المفضلة.
# 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 محدودة بـ 30 طلباً في الدقيقة. الرصيد هو الحاجز الحقيقي.
| الحالة | المعنى |
|---|---|
200 | نجح |
400 | طلب خاطئ -- تحقق من معاملاتك |
401 | غير مصرح -- مفتاح API مفقود أو غير صالح |
402 | رصيد غير كافٍ |
404 | المورد غير موجود |
429 | تجاوز الحد -- انتظر وأعد المحاولة |
500 | خطأ في الخادم -- أعد المحاولة مع تأخير تصاعدي |