Estimar el trabajo de traducción

Consulta el trabajo necesario y el coste aproximado de los documentos que vas a enviar antes de crear un trabajo de traducción.

Solicita una estimación cuando necesites revisar las tareas seleccionadas o el consumo previsto antes de traducir. El punto de acceso 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

Utiliza los mismos campos engineId, sourceLocale, targetLocales y documents que en la creación de trabajos. Se admiten JSON incluidos directamente en la solicitud, direcciones de artefactos, contenidos de origen 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, incluidas las configuraciones específicas de cada documento. La planificación también está limitada a 25 MiB de datos de entrada, 20.000 unidades de origen y 20.000 traducciones pendientes. Divide el trabajo de mayor volumen en estimaciones más pequeñas. EstimateTooLarge identifica el límite superado; EstimateDocumentInvalid identifica un documento que no se puede analizar o alinear.

Proporcionar los archivos que faltan #

Una respuesta HTTP 200 puede devolver "_tag": "MissingArtifacts" con un array uploads. Sube los bytes originales de cada dirección al uploadUrl devuelto para ella mediante un PUT autenticado y, después, repite la solicitud de estimación. Estas cargas de artefactos se realizan a nivel de organización; no se crea ningún trabajo.

Si la entrada solo contiene JSON incluido directamente en la solicitud, la estimación lo lee tal cual. Aun así, se envía contenido a Lingo.dev; no es una comprobación sin conexión.

Interpretar la estimación #

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

CampoSignificado
workRecuentos de sourceUnits, pendingTranslations y reusedTranslations.
totalsTotales previstos de tokens y costes.
conditionalPartidas separadas para el trabajo que depende de resultados posteriores.
byLocaleTraducciones pendientes y reutilizadas, costes previstos y costes condicionales para cada idioma de destino.
stagesEtapa, idioma opcional (null para el trabajo compartido), indicador de condicionalidad, recuentos de unidades y solicitudes, y coste estimado.
exclusionsTrabajo sin precio asignado, como externalHumanReview.
warningsLímites y supuestos relevantes para esta estimación.

Cada objeto de coste contiene inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd y totalCostUsd. totalCostUsd excluye el gasto BYOK facturado directamente por el proveedor, las partidas condicionales y las tarifas de revisión humana externa. Consulta estos conceptos por separado al planificar el flujo de trabajo.

Los importes son una estimación de los cargos por consumo antes de aplicar las cuotas incluidas en el plan. No constituyen una factura, un límite de gasto ni un máximo garantizado. El trabajo compartido de la etapa de origen puede aparecer con locale: null, por lo que las filas de cada idioma, por sí solas, no tienen por qué sumar el total del trabajo.

Tras revisar el plan, crea e inicia un trabajo con la revisión del contenido de origen y las opciones que quieras utilizar. La estimación no reserva trabajo ni fija precios; los cambios en el contenido de origen, las directrices, los modelos o la configuración del flujo de procesamiento pueden modificar el trabajo que finalmente se realice.