Estimar el trabajo de traducción

Consulta las tareas y el costo aproximado del envío de documentos antes de crear un trabajo de traducción.

Solicita una estimación cuando necesites revisar las tareas seleccionadas o el consumo probable de un trabajo antes de traducir. El punto de conexión planifica el procesamiento de los documentos según la configuración actual del motor, sin crear un trabajo ni ejecutar el flujo de procesamiento.

Solicitar una estimación #

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

Usa los mismos campos engineId, sourceLocale, targetLocales y documents que en la creación de trabajos. Se admiten JSON en línea, direcciones de artefactos, fuentes anteriores y traducciones anteriores. Omite las opciones exclusivas de los trabajos, 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" } }
    }
  ]
}

La solicitud admite un máximo de 100 documentos y 100 idiomas de destino distintos, incluidos los ajustes específicos de cada documento. La planificación también está limitada a 25 MiB de entrada, 20,000 unidades de origen y 20,000 traducciones pendientes. Divide las tareas de mayor volumen en estimaciones más pequeñas. EstimateTooLarge identifica el límite excedido; EstimateDocumentInvalid identifica un documento que no se puede analizar o alinear.

Proporcionar los archivos faltantes #

Una respuesta HTTP 200 puede devolver "_tag": "MissingArtifacts" con un arreglo uploads. Carga los bytes originales de cada dirección en el uploadUrl devuelto mediante un PUT autenticado y luego repite la solicitud de estimación. Estas cargas corresponden a artefactos de la organización; no se crea ningún trabajo.

Si la entrada contiene solo JSON en línea, la estimación lee directamente el JSON proporcionado. Aun así, la estimación envía contenido a Lingo.dev; no es una verificación sin conexión.

Leer la estimación #

Cuando la estimación está lista, la respuesta contiene "_tag": "Estimated" y approximate: true:

CampoSignificado
workCantidades de sourceUnits, pendingTranslations y reusedTranslations.
totalsTotales previstos de tokens y costos.
conditionalPrevisiones de costos separadas para tareas que dependen de resultados posteriores.
byLocaleTraducciones pendientes y reutilizadas, costos previstos y costos condicionales para cada idioma de destino.
stagesEtapa, idioma opcional (null para tareas compartidas), indicador condicional, cantidades de unidades y solicitudes, y costo estimado.
exclusionsTareas sin precio definido, como externalHumanReview.
warningsLímites y supuestos relevantes para esta estimación.

Cada objeto de costo contiene inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd y totalCostUsd. totalCostUsd excluye los gastos de BYOK pagados directamente al proveedor, las previsiones de costos condicionales y las tarifas de revisión humana externa. Consulta esos conceptos por separado al planificar el flujo de trabajo.

Los importes estiman los cargos por consumo antes de aplicar las asignaciones del plan. No constituyen una factura, un límite de gasto ni un máximo garantizado. Las tareas compartidas de la etapa de origen pueden aparecer con locale: null, por lo que la suma de las filas por idioma no necesariamente coincide con el total del trabajo completo.

Después de revisar el plan, crea e inicia un trabajo con la revisión de origen y las opciones deseadas. La estimación no reserva tareas ni garantiza precios; los cambios en el contenido de origen, las directrices, los modelos o la configuración del flujo de procesamiento pueden modificar las tareas que finalmente se realicen.