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 #

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

Utilize 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.

json
{
  "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:

CampoSignificado
workContagens de sourceUnits, pendingTranslations e reusedTranslations.
totalsTotais previstos de tokens e custos.
conditionalProvisões separadas para 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 partilhado), indicador de condição, contagens de unidades e pedidos e custo estimado.
exclusionsTrabalho sem preço definido, como externalHumanReview.
warningsLimites 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.