API перекладу
Надсилайте свої документи до Edgepedia Translate зі скрипту й отримуйте переклади. Це той самий сервіс, що й на сторінці перекладу, за тими самими цінами й з оплатою з того самого балансу кредитів.
Отримання ключа
Створіть ключ на сторінці перекладу: увійдіть, відкрийте меню облікового запису вгорі праворуч і натисніть «Створити» в розділі «Ключі API».
Передавайте ключ у кожному запиті як Authorization: Bearer ept_…. Тримайте його в таємниці: кожен, хто має цей ключ, може витрачати ваші кредити.
Ціни
- Стандартний: 1 кредит за 250 слів (щонайменше 1).
- Pro: 1 кредит за 75 слів (щонайменше 2).
- Для перекладу між двома мовами, жодна з яких не є англійською, ціна подвоюється.
- 100 кредитів = USD 1.
У разі невдалого перекладу кредити повертаються.
Маршрути
Базова 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": у відповіді поле "detected": true називає мову, визначену в "source", і з цим кодом ви потім запускаєте переклад.
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 розміром до 10 MB. Додайте "expect_credits", щоб отримати відмову (409), якщо ціна відрізняється від очікуваної. Додайте "wait" (до 120 секунд), щоб отримати готовий переклад у тій самій відповіді.
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) і, після завершення, його текст. У разі невдачі вказується причина. Готовий переклад можна отримати протягом 30 днів.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
Результат перекладу файлу: .docx для файлів .docx і .pdf, текст для .txt і .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Ваші переклади, починаючи з найновіших, до 50.
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 | Розмір файлу перевищує 10 MB. |
| 429 | Понад 60 запитів за хвилину; повторіть спробу через Retry-After секунд. |