Как оценить объём перевода
Узнайте объём работы и примерную стоимость перевода документов до создания задания.
Запросите оценку задания, чтобы до начала перевода проверить выбранный объём работы или ожидаемый расход ресурсов. Эндпоинт планирует обработку документов с учётом текущей конфигурации движка, не создавая задание и не запуская пайплайн.
Как запросить оценку #
POST /v2/organizations/:orgId/localization/estimates
Content-Type: application/json
X-API-Key: YOUR_API_KEYИспользуйте те же поля engineId, sourceLocale, targetLocales и documents, что и при создании задания. Поддерживаются встроенный JSON, адреса артефактов, предыдущие исходные тексты и переводы. Не указывайте параметры, которые относятся только к заданию, например originId.
{
"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, поэтому сумма строк по локалям не обязательно совпадает с итогом по всему заданию.
Изучив план, создайте и запустите задание с нужной версией исходного текста и параметрами. Оценка не резервирует работу и не фиксирует цены. Изменения исходного текста, рекомендаций, моделей или настроек пайплайна могут повлиять на итоговый объём работы.