估算翻译工作量
创建翻译任务前,预览提交文档所需的工作量和大致费用。
如果需要在翻译前了解任务选定的工作内容或预计用量,可以先进行估算。此端点会根据引擎的当前配置规划文档处理工作,但不会创建任务或执行流水线。
请求估算 #
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 MiB 的输入、20,000 个源单元和 20,000 条待翻译内容。工作量较大时,请拆分为多个较小的估算请求。EstimateTooLarge 指明超出的限制;EstimateDocumentInvalid 指明无法解析或对齐的文档。
补充缺失的文件 #
HTTP 200 响应可能返回带有 uploads 数组的 "_tag": "MissingArtifacts"。请使用经过身份验证的 PUT,将每个地址对应的原始字节上传至返回的 uploadUrl,然后再次发送估算请求。这些文件会作为组织级制品上传,不会创建任务。
如果输入仅包含内联内容,估算会直接读取提供的 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 标示,因此仅将各语言区域行的金额相加,不一定等于整个任务的总额。
查看计划后,请使用计划采用的源内容修订版本和选项创建并启动任务。估算不会预留工作或锁定价格;源内容、指导信息、模型或流水线设置发生变化,都可能改变最终需要执行的工作。