edgepedia ترجمه

⁦API⁩ ترجمه

با استفاده از یک اسکریپت، سندهای خود را به ترجمهٔ ⁦Edgepedia⁩ بفرستید و ترجمه‌ها را دریافت کنید. این همان سرویس صفحهٔ ترجمه است، با همان هزینه‌ها که از همان اعتبار شما پرداخت می‌شوند.

دریافت کلید

در صفحهٔ ترجمه یک کلید بسازید: وارد شوید، حساب کاربری خود را در بالا سمت چپ باز کنید و در بخش «کلیدهای ⁦API⁩»، «ایجاد» را انتخاب کنید.

کلید را در هر درخواست به‌صورت Authorization: Bearer ept_… ارسال کنید. آن را محرمانه نگه دارید: هرکس آن را در اختیار داشته باشد، می‌تواند اعتبار شما را مصرف کند.

هزینه‌ها

اگر ترجمه ناموفق باشد، اعتبار مصرف‌شده بازگردانده می‌شود.

مسیرها

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