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

سه روش

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 را باز کنید تا نتیجه دانلود شود.

مرجع اندپوینت‌ها

منابع

OpenAPI تنها قرارداد ساختاریافته API است.