Estimar o trabalho de tradução
Veja o trabalho previsto e o custo aproximado do envio de documentos antes de criar uma tarefa de tradução.
Peça uma estimativa de uma tarefa para analisar o trabalho selecionado ou o consumo provável antes da tradução. O ponto de acesso planeia o processamento dos documentos com base na configuração atual do motor, sem criar uma tarefa nem executar o fluxo de processamento.
Pedir uma estimativa #
POST /v2/organizations/:orgId/localization/estimates
Content-Type: application/json
X-API-Key: YOUR_API_KEYUtilize os mesmos campos engineId, sourceLocale, targetLocales e documents que na criação de tarefas. Pode fornecer JSON incorporado, endereços de artefactos, conteúdos de origem anteriores e traduções anteriores. Omita as opções exclusivas das tarefas, como originId.
{
"engineId": "YOUR_ENGINE_ID",
"sourceLocale": "en",
"targetLocales": ["es"],
"documents": [
{
"key": "messages.json",
"format": { "type": "json" },
"source": { "content": { "save": "Save changes", "cancel": "Cancel" } }
}
]
}O pedido aceita, no máximo, 100 documentos e 100 idiomas de destino distintos, incluindo definições específicas por documento. O planeamento está também limitado a 25 MiB de dados de entrada, 20 000 unidades de origem e 20 000 traduções pendentes. Divida trabalhos maiores em estimativas mais pequenas. EstimateTooLarge identifica o limite excedido; EstimateDocumentInvalid identifica um documento que não é possível analisar ou alinhar.
Fornecer os ficheiros em falta #
Uma resposta HTTP 200 pode devolver "_tag": "MissingArtifacts" com uma lista uploads. Envie os bytes originais correspondentes a cada endereço para o respetivo uploadUrl devolvido, através de um PUT autenticado, e repita o pedido de estimativa. Estes envios carregam artefactos para a organização; não é criada nenhuma tarefa.
Se fornecer apenas dados incorporados, a estimativa lê diretamente o JSON fornecido. O processo de estimativa envia conteúdo para o Lingo.dev na mesma; não se trata de uma verificação local sem ligação à Internet.
Ler a estimativa #
Quando a estimativa está pronta, a resposta contém "_tag": "Estimated" e approximate: true:
| Campo | Significado |
|---|---|
work | Contagens de sourceUnits, pendingTranslations e reusedTranslations. |
totals | Totais previstos de tokens e custos. |
conditional | Provisões separadas para trabalho que depende de resultados posteriores. |
byLocale | Traduções pendentes e reutilizadas, custos previstos e custos condicionais para cada idioma de destino. |
stages | Etapa, idioma opcional (null para trabalho partilhado), indicador de condição, contagens de unidades e pedidos e custo estimado. |
exclusions | Trabalho sem preço definido, como externalHumanReview. |
warnings | Limites e pressupostos relevantes para esta estimativa. |
Cada objeto de custo contém inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd e totalCostUsd. totalCostUsd exclui despesas BYOK pagas diretamente ao fornecedor, provisões condicionais e custos externos de revisão humana. Consulte estes valores separadamente ao planear o workflow.
Os montantes são estimativas dos encargos de consumo antes da aplicação das franquias do plano. Não constituem uma fatura, um limite de despesas nem um limite máximo garantido. O trabalho partilhado da etapa de origem pode aparecer com locale: null, pelo que a soma das linhas por idioma, por si só, pode não corresponder ao total da tarefa.
Depois de analisar o plano, crie e inicie uma tarefa com a revisão do conteúdo de origem e as opções pretendidas. A estimativa não reserva trabalho nem garante preços; alterações ao conteúdo de origem, às orientações, aos modelos ou às definições do fluxo de processamento podem alterar o trabalho efetivamente realizado.