חיבור לסוכני AI
אפשר להשתמש ב-Equalang ישירות מתוך סוכן קוד, או לקרוא ל-API הסטנדרטי בעצמכם.
שלוש דרכים
אפשר להשתמש ב-Equalang מתוך Claude Code, Codex, Cursor או כל סוכן קוד אחר. שלוש הדרכים משתמשות באותה יתרת קרדיטים.
בלי שום הגדרות. העתיקו את המשפט הזה לסוכן שלכם: הוא יקרא בעצמו את הוראות ההתקנה, ישכפל את ה-Skill לתיקייה שממנה הוא טוען, ויבקש מכם מפתח.
פרומפט
Install the Equalang skill by following the instructions at https://equalang.com/install/skill-install.md
כל שלוש הדרכים דורשות מפתח API.קבלת מפתח API
סקירה כללית
תרגום טקסט מחזיר את התרגום מיד; תרגום מסמך יוצר משימה, שאת התקדמותה עוקבים ואת תוצאתה מורידים.
- נתיב הבסיס של ה-API
- /v1
- פורמט התגובה
- נקודות הקצה העסקיות מחזירות מבנה JSON אחיד; נקודות הקצה של תוכן קבצים מחזירות נתונים בינאריים. סכמת OpenAPI היא JSON סטנדרטי.
- חיוב
- אותה יתרת קרדיטים כמו באתר. החיוב בפועל מופיע ב-usage.credits_charged.
אימות
צרו מפתח API בחשבון ושלחו אותו כ-Bearer Token בכותרת Authorization של כל בקשה מוגנת.
HTTP
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.