Открыть оглавление

API перевода текста

Переведите текст на нужный язык с учётом контекста и терминологии.

Создайте ключ в консоли API и передавайте его в заголовке Authorization: Bearer <API_KEY>. Перед запуском примеров задайте LECSYNC_API_KEY в окружении сервера. Храните ключ на сервере.

Отправка запроса

POST /v1/translate

bash
curl "https://api.lecsync.com/v1/translate" \  -H "Authorization: Bearer $LECSYNC_API_KEY" \  -H "Idempotency-Key: translation-example-001" \  -H "Content-Type: application/json" \  -d '{  "text": "Hello world.",  "source_lang": "en",  "target_lang": "zh",  "context": "A welcome message.",  "terms": [    {      "source": "world",      "target": "世界"    }  ]}'

Параметры

ПолеТипОбязательноОписание
textstringДаНепустая строка, до 2000 символов Unicode.
target_langstringДаКод целевого языка, например ru, en или zh.
source_langstringНетИсходный язык; по умолчанию auto. Для короткого или неоднозначного текста лучше задать явно.
contextstringНетКонтекст, до 2000 символов Unicode.
termsobject[]НетДо 20 пар {source, target}, каждая сторона до 120 символов Unicode.
modelstringНетНеобязательный идентификатор модели; указанное значение используется по умолчанию. translate-default.

Ответ

Примеры показывают основные поля; ответ также может содержать метаданные использования.

json
{  "request_id": "req_example",  "status": "succeeded",  "text": "你好,世界。",  "source_lang": "en",  "target_lang": "zh",  "model": "translate-default",  "unchanged": false}
ПолеОписание
request_idИдентификатор запроса для проверки состояния и диагностики; сохраните его.
statusaccepted, processing, succeeded, failed или cancelled.
textПереведённый текст.
source_langИсходный язык; по умолчанию auto. Для короткого или неоднозначного текста лучше задать явно.
target_langКод целевого языка, например ru, en или zh.
unchangedtrue, если исходный и целевой языки совпадают; текст возвращён без изменений.
result_expires_atСрок хранения результата в ISO 8601; до готовности может быть null.

Получение результата и повторы

Каждый новый запрос на выполнение должен содержать Idempotency-Key: 1–128 видимых ASCII-символов. Сохраните ключ и повторите его с теми же параметрами, если ответ потерян. Другие параметры с тем же ключом дают 409 IDEMPOTENCY_CONFLICT. Пока запрос выполняется, повтор возвращает его состояние без нового запуска. Новый ключ создаёт новый запрос.

Успешные результаты по умолчанию хранятся 24 часа. Получите их через GET /v1/requests/{request_id}: сохранённое содержимое находится в result. Повтор успешного POST также использует эту обёртку. После истечения срока возвращается 410 RESULT_EXPIRED. Точный срок указан в result_expires_at.

bash
curl "https://api.lecsync.com/v1/requests/REQUEST_ID" \  -H "Authorization: Bearer $LECSYNC_API_KEY"

Ограничения и использование

Учитываются символы исходного текста; контекст и термины не учитываются. Совпадение языков не отменяет учёт.

usage.charge_cents — сумма в центах США в виде десятичной строки.

GET /v1/models возвращает доступные модели, языки, ограничения, цены и сроки хранения результатов.

Ошибки

HTTP-ошибка содержит error и request_id; идентификатор также есть в заголовке X-Request-Id. Сохраняйте его для диагностики.

json
{  "error": "INVALID_INPUT",  "request_id": "req_example"}
HTTPerrorДействие
401UNAUTHORIZEDПроверьте API Key.
402INSUFFICIENT_BALANCEПроверьте баланс API перед повтором.
503ADMISSION_DISABLEDСервис недоступен для этой учётной записи.
409IDEMPOTENCY_CONFLICTПроверьте существующий запрос; для другого ввода используйте новый ключ.
410RESULT_EXPIREDРезультат истёк; при необходимости создайте новый запрос.
422INVALID_INPUT / INVALID_IDEMPOTENCY_KEY / PARAMETER_CONFLICT / CAPABILITY_UNAVAILABLEПроверьте имена, типы и обязательные поля.
422UNSUPPORTED_LANGUAGE / LANGUAGE_UNDETERMINEDИспользуйте поддерживаемый язык; при сбое автоопределения задайте source_lang.
429RESOURCE_LIMITПовторите после интервала Retry-After.
503MODEL_UNAVAILABLE / SERVICE_UNAVAILABLEПеред повтором проверьте состояние запроса.
504DEADLINE_EXCEEDEDПеред новым запросом проверьте состояние текущего.