edgepedia ترجمة

⁦API⁩ الترجمة

أرسل مستنداتك إلى خدمة الترجمة من ⁦Edgepedia⁩ عبر برنامج نصي، واحصل على ترجماتها. إنها الخدمة نفسها المتاحة في صفحة الترجمة، بالأسعار نفسها، وتُخصم تكلفتها من الرصيد نفسه.

الحصول على مفتاح

أنشئ مفتاحًا من صفحة الترجمة: سجّل الدخول، وافتح حسابك في أعلى اليسار، ثم اختر «إنشاء» ضمن «مفاتيح ⁦API⁩».

أرسل المفتاح مع كل طلب بالصيغة Authorization: Bearer ept_…. احتفظ به سرًا: فكل من يملكه يستطيع الإنفاق من رصيدك.

الأسعار

تُعاد وحدات الرصيد عند فشل الترجمة.

المسارات

عنوان ⁦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.