документация

Справочник по API.

Каждый эндпоинт, который можно вызвать с помощью API-ключа, генерируется из того же манифеста, что и маршруты API, с реальными примерами запросов и ответов, проверенными по актуальным схемам. Начните с быстрый старт для разработчиков для сквозного прохождения.

Пишете на JavaScript или TypeScript? Возможно, вам вообще не нужен API в чистом виде. Смотреть пакеты →

соглашения

Формат каждого запроса.

Один базовый URL, один заголовок Bearer, JSON на вход и выход. Ключи имеют области видимости (translate:write, jobs:read), и для маршрута требуется соответствующая. Управление аккаунтом, биллингом, командой, вебхуками и ключами находится в интерфейсе приложения, а не в API — ключ не может создавать ключи или менять оплату.

базовый URL

https://api.echo-lingua.com/v1

каждый запрос

Authorization: Bearer elk_live_2b7f…
Content-Type: application/json

справочник · эндпоинты 19

Эндпоинты, вызываемые с помощью ключа.

Нажмите на любой эндпоинт, чтобы посмотреть его параметры, примеры запроса и ответа, а также готовый код на cURL, JS/TS, Python и PHP. Для каждого указана необходимая область видимости; GET /v1/health — это Публичный и не требует авторизации. Операции, доступные только в панели управления и административные, здесь не указаны — для них требуется активная сессия входа, а не ключ.

Задачи

Пакетный пайплайн: создайте задачу, оцените объем, отслеживайте выполнение и скачайте архив готовой структуры репозитория. Проверяйте, повторяйте неуспешные элементы или запускайте обработку заново.

Синхронный перевод

Переводите строки или литералы в фрагменте кода «на лету» без создания задач. Оплата аналогична пакетным задачам.

Шаблоны

Создавайте пустые PO-файлы для локалей из исходника без перевода и без списания средств.

Использование и стоимость

Получайте данные об использовании за текущий период, расходах и лимитах программным путем.

Служба

Публичный эндпоинт проверки работоспособности для мониторинга.

Показано 19 из 19 конечных точек

стоимость чтения

Все суммы указаны в микро-USD.

Денежные суммы в API представлены в виде целочисленного количества микро-USD (миллионных долей доллара США), поэтому 1 000 000 соответствует $1. Делите на миллион, чтобы получить доллары. Использование целых чисел гарантирует отсутствие ошибок округления: небольшая задача может законно стоить несколько десятых долей цента.

микро-USD → USD

// Every *Micros field is an integer count of micro-USD (millionths of a dollar).
const usd = (micros) => micros / 1_000_000;

usd(52500);      // 0.0525   → about 5¢
usd(322500);     // 0.3225   → about 32¢
usd(1_000_000);  // 1.00     → one dollar

// Format it for display:
const fmt = (micros) =>
  new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' })
    .format(micros / 1_000_000);   // fmt(52500) → "$0.05"

Денежные поля

chargedMicros — сумма, которая будет списана с вашего баланса за задачу или расчетную стоимость.

creditRequiredMicros — баланс, необходимый для начала выполнения задачи: стоимость плюс небольшой резерв безопасности.

Итоговые значения использования из GET /v1/usage используют ту же единицу измерения.

Пример: chargedMicros в размере 52500 составляет $0.0525.

Интегрируйте в свой пайплайн.

Создайте ключ с ограничениями, отправьте одну задачу через POST и дождитесь подписанного вебхука о ее завершении.

Читать руководство разработчика