API ترجمه
با استفاده از یک اسکریپت، سندهای خود را به ترجمهٔ Edgepedia بفرستید و ترجمهها را دریافت کنید. این همان سرویس صفحهٔ ترجمه است، با همان هزینهها که از همان اعتبار شما پرداخت میشوند.
دریافت کلید
در صفحهٔ ترجمه یک کلید بسازید: وارد شوید، حساب کاربری خود را در بالا سمت چپ باز کنید و در بخش «کلیدهای API»، «ایجاد» را انتخاب کنید.
کلید را در هر درخواست بهصورت Authorization: Bearer ept_… ارسال کنید. آن را محرمانه نگه دارید: هرکس آن را در اختیار داشته باشد، میتواند اعتبار شما را مصرف کند.
هزینهها
- استاندارد: ۱ اعتبار بهازای هر ۲۵۰ واژه (حداقل ۱ اعتبار).
- Pro: ۱ اعتبار بهازای هر ۷۵ واژه (حداقل ۲ اعتبار).
- برای ترجمه میان دو زبانی که هیچکدام انگلیسی نیستند، هزینه دو برابر میشود.
- ۱۰۰ اعتبار = ۱ USD.
اگر ترجمه ناموفق باشد، اعتبار مصرفشده بازگردانده میشود.
مسیرها
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 با حجم حداکثر ۱۰ مگابایت را آغاز کنید. با افزودن "expect_credits"، اگر هزینه با مقدار مورد انتظار شما متفاوت باشد، درخواست رد میشود (409). برای دریافت ترجمهٔ کامل در همان پاسخ، "wait" را اضافه کنید (حداکثر ۱۲۰ ثانیه).
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) و پس از تکمیل، متن آن. اگر ترجمه ناموفق باشد، دلیل آن ذکر میشود. ترجمهٔ تکمیلشده تا ۳۰ روز قابل دریافت است.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
خروجی ترجمهٔ فایل: برای فایلهای .docx و .pdf، یک فایل .docx و برای فایلهای .txt و .md، متن.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
ترجمههای شما، از جدیدترین به قدیمیترین، حداکثر ۵۰ مورد.
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 | حجم فایل بیش از ۱۰ مگابایت است. |
| 429 | بیش از ۶۰ درخواست در یک دقیقه؛ پس از تعداد ثانیهٔ مشخصشده در Retry-After دوباره تلاش کنید. |