API الترجمة
أرسل مستنداتك إلى خدمة الترجمة من Edgepedia عبر برنامج نصي، واحصل على ترجماتها. إنها الخدمة نفسها المتاحة في صفحة الترجمة، بالأسعار نفسها، وتُخصم تكلفتها من الرصيد نفسه.
الحصول على مفتاح
أنشئ مفتاحًا من صفحة الترجمة: سجّل الدخول، وافتح حسابك في أعلى اليسار، ثم اختر «إنشاء» ضمن «مفاتيح API».
أرسل المفتاح مع كل طلب بالصيغة Authorization: Bearer ept_…. احتفظ به سرًا: فكل من يملكه يستطيع الإنفاق من رصيدك.
الأسعار
- قياسي: وحدة رصيد واحدة لكل 250 كلمة (بحد أدنى وحدة رصيد واحدة).
- Pro: وحدة رصيد واحدة لكل 75 كلمة (بحد أدنى وحدتَي رصيد).
- يتضاعف السعر عند الترجمة بين لغتين ليست أيٌّ منهما الإنجليزية.
- 100 وحدة رصيد = 1 USD.
تُعاد وحدات الرصيد عند فشل الترجمة.
المسارات
عنوان URL الأساسي: https://translate.edgepedia.ai. الطلبات والردود بصيغة JSON؛ ويأتي الخطأ بالصيغة {"error": "…"}.
GET /api/v1/languages
اللغات، مع بيان ما إذا كان وضع Pro متاحًا لكل منها.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
رصيدك.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
سعر الترجمة والوقت المتوقع لها، دون بدئها. تكون قيمة mode إما standard أو pro.
يقبل طلب تقدير السعر أيضًا "source": "auto": ويبيّن الرد اللغة المكتشفة في "source"، باستخدام "detected": true، ثم ابدأ الترجمة برمز تلك اللغة.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
ابدأ ترجمة نص، أو ملف بصيغة .txt أو .md أو .docx أو .pdf بحجم يصل إلى 10 MB. أضف "expect_credits" ليُرفض الطلب (409) إذا اختلف السعر عما تتوقعه. وأضف "wait" (حتى 120 ثانية) لتصلك الترجمة المكتملة في الرد نفسه.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
حالة الترجمة (queued أو running أو done أو failed)، ونصها عند اكتمالها. ويُذكر سبب الفشل إن فشلت. يمكن جلب الترجمة المكتملة لمدة 30 يومًا.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
نتيجة ترجمة ملف: ملف .docx لملفات .docx و.pdf، ونص لملفات .txt و.md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
ترجماتك، بدءًا بالأحدث، حتى 50 ترجمة.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
رموز الحالة
| الرمز | المعنى |
|---|---|
| 200 | OK؛ عند البدء باستخدام wait، تكون الترجمة قد اكتملت أو فشلت. |
| 202 | بدأت الترجمة، أو لا تزال قيد التشغيل بعد wait. |
| 400 | لا يمكن تنفيذ طلب الترجمة بصيغته المرسلة؛ وتوضح رسالة الخطأ السبب. |
| 401 | المفتاح مفقود أو غير معروف أو مُبطَل. |
| 402 | الرصيد غير كافٍ. |
| 404 | لا توجد مثل هذه الترجمة في حسابك. |
| 409 | السعر لا يطابق expect_credits الخاص بك؛ لم يُخصم أي مبلغ. |
| 413 | حجم الملف يتجاوز 10 MB. |
| 429 | أكثر من 60 طلبًا في دقيقة؛ حاول مجددًا بعد عدد الثواني المحدد في Retry-After. |