edgepedia перевод

API перевода

Отправляйте свои документы в Edgepedia Translate из скрипта и получайте переводы. Это тот же сервис, что и на странице «Перевод», с теми же ценами и оплатой с того же баланса кредитов.

Получение ключа

Создайте ключ на странице «Перевод»: войдите, откройте меню аккаунта в правом верхнем углу и нажмите «Создать» в разделе «Ключи 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 размером до 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

Коды состояния

КодЗначение
200OK; при запуске с wait перевод выполнен или завершился ошибкой.
202Запущено или всё ещё выполняется после wait.
400Запрос нельзя перевести в переданном виде; причина указана в ошибке.
401Ключ отсутствует, неизвестен или отозван.
402Недостаточно кредитов.
404В вашем аккаунте нет такого перевода.
409Цена не совпадает с вашим значением expect_credits; ничего не списано.
413Размер файла превышает 10 MB.
429Более 60 запросов за минуту; повторите запрос через Retry-After секунд.