Estimar o trabalho de tradução

Veja uma prévia do trabalho e do custo aproximado de um envio de documentos antes de criar uma tarefa de tradução.

Solicite uma estimativa quando precisar conferir o trabalho selecionado ou o consumo provável de uma tarefa antes da tradução. O endpoint planeja o processamento dos documentos com base na configuração atual do engine, sem criar uma tarefa nem executar o pipeline.

Solicitar uma estimativa #

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

Use os mesmos campos engineId, sourceLocale, targetLocales e documents da criação de tarefas. Há suporte para JSON inline, endereços de artefatos, fontes anteriores e traduções anteriores. Omita as opções exclusivas de tarefas, como originId.

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

A solicitação aceita no máximo 100 documentos e 100 idiomas de destino distintos, incluindo configurações específicas por documento. O planejamento também está limitado a 25 MiB de entrada, 20.000 unidades de origem e 20.000 traduções pendentes. Divida trabalhos maiores em estimativas menores. EstimateTooLarge identifica o limite excedido; EstimateDocumentInvalid identifica um documento que não pode ser analisado ou alinhado.

Fornecer os arquivos ausentes #

Uma resposta HTTP 200 pode retornar "_tag": "MissingArtifacts" com um array uploads. Envie os bytes originais correspondentes a cada endereço para o respectivo uploadUrl retornado, usando um PUT autenticado. Depois, repita a solicitação de estimativa. Esses uploads são de artefatos da organização; nenhuma tarefa é criada.

Quando a entrada contém apenas JSON inline, a estimativa lê diretamente o JSON fornecido. Mesmo assim, o conteúdo é enviado para a Lingo.dev; não se trata de uma verificação offline.

Ler a estimativa #

Quando está pronta, a resposta contém "_tag": "Estimated" e approximate: true:

CampoSignificado
workContagens de sourceUnits, pendingTranslations e reusedTranslations.
totalsTotais previstos de tokens e custos.
conditionalProvisões separadas para o trabalho que depende de resultados posteriores.
byLocaleTraduções pendentes e reutilizadas, custos previstos e custos condicionais para cada idioma de destino.
stagesEtapa, idioma opcional (null para trabalho compartilhado), indicador condicional, contagens de unidades e solicitações e custo estimado.
exclusionsTrabalho sem preço definido, como externalHumanReview.
warningsLimites e premissas relevantes para esta estimativa.

Cada objeto de custo contém inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd e totalCostUsd. totalCostUsd exclui gastos com BYOK pagos diretamente ao provedor, provisões condicionais e taxas de revisão humana externa. Consulte esses valores separadamente ao planejar o workflow.

Os valores são estimativas das cobranças pelo consumo antes da aplicação das franquias do plano. Não representam uma fatura, um limite de gastos nem um teto garantido. O trabalho compartilhado da etapa de origem pode aparecer com locale: null; por isso, a soma das linhas por idioma não corresponde necessariamente ao total da tarefa.

Depois de analisar o planejamento, crie e inicie uma tarefa com a revisão do conteúdo de origem e as opções desejadas. A estimativa não reserva trabalho nem garante preços; alterações no conteúdo de origem, nas orientações, nos modelos ou nas configurações do pipeline podem mudar o trabalho efetivamente realizado.