اتصال به ایجنت

سه روش

Equalang را در Claude Code، Codex، Cursor یا هر ایجنت برنامه‌نویسی دیگری به کار ببرید. هر سه روش از یک موجودی اعتبار مشترک استفاده می‌کنند.

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

نمای کلی

ترجمه متن نتیجه را بی‌درنگ برمی‌گرداند؛ برای ترجمه اسناد، کاری می‌سازید، پیشرفتش را پیگیری می‌کنید و نتیجه را دانلود می‌کنید.

مسیر پایه API

/v1

قالب پاسخ

نقطه‌های پایانی کسب‌وکار یک ساختار JSON یکسان برمی‌گردانند؛ نقطه‌های پایانی محتوای فایل، داده دودویی برمی‌گردانند. OpenAPI Schema به‌صورت JSON استاندارد است.

صورت‌حساب

از همان موجودی اعتبار وب‌سایت استفاده می‌کند؛ مبلغ کسرشده واقعی در usage.credits_charged آمده است.

احراز هویت

در حساب کاربری خود یک کلید API بسازید و آن را در سرآیند Authorization هر درخواست محافظت‌شده، به‌صورت Bearer Token بفرستید.

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 تنها قرارداد ساختاریافته API است.