API перевода
Отправляйте свои документы в Edgepedia Translate из скрипта и получайте переводы. Это тот же сервис, что и на странице «Перевод», с теми же ценами и оплатой с того же баланса кредитов.
Получение ключа
Создайте ключ на странице «Перевод»: войдите, откройте меню аккаунта в правом верхнем углу и нажмите «Создать» в разделе «Ключи API».
Передавайте ключ в каждом запросе в виде Authorization: Bearer ept_…. Храните его в секрете: любой, у кого он есть, может тратить ваши кредиты.
Цены
- Стандартный: 1 кредит за 250 слов (минимум 1 кредит).
- Pro: 1 кредит за 75 слов (минимум 2 кредита).
- Если ни один из двух языков не английский, цена удваивается.
- 100 кредитов = 1 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 размером до 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 секунд. |