الربط مع Agent

ثلاث طرق

استخدم Equalang من Claude Code أو Codex أو Cursor أو أي Agent برمجة. الطرق الثلاث تستخدم رصيد الأرصدة نفسه.

Install the Equalang skill by following the instructions at https://equalang.com/install/skill-install.md

نظرة عامة

ارفع المستند وأنشئ مهمة الترجمة بطلب واحد، ثم استعلم عن التقدم وحمّل النتيجة. يمكنك أيضًا إعادة استخدام الملفات المرفوعة سابقًا.

المسار الأساسي لـ API

/v1

صيغة الاستجابة

نقاط النهاية الخاصة بالأعمال تعيد بنية JSON موحدة؛ ونقاط نهاية محتوى الملفات تعيد بيانات ثنائية. مخطط OpenAPI يستخدم JSON قياسيًا.

الفوترة

رصيد مشترك مع الموقع، والتسعير حسب رموز النص المصدر. المبلغ النهائي في usage.credits_charged؛ تُحتسب الترجمة المكتملة حتى إذا فشل تسليم النتيجة.

المصادقة

أنشئ مفتاح API في حسابك وأرسله كـ Bearer token في ترويسة Authorization مع كل طلب محمي. يُعرض المفتاح كاملًا مرة واحدة فقط عند الإنشاء.

Authorization: Bearer el_...

أنشئ أول مهمة

ارفع المستند وحدد اللغة الهدف، ثم استخدم job_id لمتابعة التقدم.

curl --fail-with-body "https://test.equalang.com/v1/jobs/translate" \
  -H "Authorization: Bearer $EQ_API_KEY" \
  -F "file=@report.pdf" \
  -F "target_language=zh-CN"
# -> { "data": { "job_id": "..." } }

# استخدم job_id المعاد. كرر حتى تصبح data.finished تساوي true.
curl --fail-with-body "https://test.equalang.com/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $EQ_API_KEY"
# عند SUCCEEDED، افتح data.download_url لتنزيل النتيجة.

مرجع API

قائمة نقاط النهاية هذه تُقرأ مباشرة من مخطط OpenAPI الخاص بهذا النشر — فهي تتحدّث مع الخدمة بدلًا من أن تصبح وثيقة تخالف التنفيذ الفعلي.

موارد مرجعية

OpenAPI هو العقد الهيكلي الوحيد لواجهة API.