Как оценить объём перевода

Узнайте объём работы и примерную стоимость перевода документов до создания задания.

Запросите оценку задания, чтобы до начала перевода проверить выбранный объём работы или ожидаемый расход ресурсов. Эндпоинт планирует обработку документов с учётом текущей конфигурации движка, не создавая задание и не запуская пайплайн.

Как запросить оценку #

http
POST /v2/organizations/:orgId/localization/estimates
Content-Type: application/json
X-API-Key: YOUR_API_KEY

Используйте те же поля engineId, sourceLocale, targetLocales и documents, что и при создании задания. Поддерживаются встроенный JSON, адреса артефактов, предыдущие исходные тексты и переводы. Не указывайте параметры, которые относятся только к заданию, например originId.

json
{
  "engineId": "YOUR_ENGINE_ID",
  "sourceLocale": "en",
  "targetLocales": ["es"],
  "documents": [
    {
      "key": "messages.json",
      "format": { "type": "json" },
      "source": { "content": { "save": "Save changes", "cancel": "Cancel" } }
    }
  ]
}

В одном запросе можно передать не более 100 документов и 100 уникальных целевых локалей, включая переопределения для отдельных документов. Для планирования также действуют лимиты: 25 МиБ входных данных, 20 000 единиц исходного текста и 20 000 переводов, ожидающих выполнения. Если объём больше, разбейте его на несколько запросов оценки. EstimateTooLarge указывает, какой лимит превышен, а EstimateDocumentInvalid — какой документ не удаётся разобрать или сопоставить.

Как загрузить недостающие файлы #

Ответ HTTP 200 может содержать "_tag": "MissingArtifacts" с массивом uploads. Для каждого адреса загрузите исходные байты по соответствующему uploadUrl с помощью PUT с аутентификацией. Затем повторите запрос оценки. При этом артефакты загружаются в организацию, а задание не создаётся.

Если все входные данные встроены в запрос, для оценки напрямую используется переданный JSON. При оценке содержимое всё равно отправляется в Lingo.dev — это не офлайн-проверка.

Как прочитать оценку #

Ответ с готовой оценкой содержит "_tag": "Estimated" и approximate: true:

ПолеЗначение
workКоличество sourceUnits, pendingTranslations и reusedTranslations.
totalsПланируемое общее количество токенов и общая стоимость.
conditionalОтдельные суммы на работу, необходимость которой зависит от последующих результатов.
byLocaleПереводы, ожидающие выполнения, повторно используемые переводы, планируемые и условные затраты для каждой целевой локали.
stagesЭтап, необязательная локаль (null для общей работы), флажок условности, количество единиц и запросов, а также примерная стоимость.
exclusionsРабота, для которой стоимость не рассчитана, например externalHumanReview.
warningsОграничения и допущения для этой оценки.

Каждый объект стоимости содержит inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd и totalCostUsd. totalCostUsd не включает расходы, оплачиваемые напрямую провайдеру при использовании BYOK, условные суммы и плату за внешнюю ручную проверку. При планировании рабочего процесса учитывайте их отдельно.

Суммы отражают примерную плату за использование до учёта объёмов, включённых в план. Это не счёт, не лимит расходов и не гарантированная верхняя граница стоимости. Общая работа на этапе обработки исходного текста может отображаться с locale: null, поэтому сумма строк по локалям не обязательно совпадает с итогом по всему заданию.

Изучив план, создайте и запустите задание с нужной версией исходного текста и параметрами. Оценка не резервирует работу и не фиксирует цены. Изменения исходного текста, рекомендаций, моделей или настроек пайплайна могут повлиять на итоговый объём работы.