Estimer le travail de traduction

Évaluez le travail à effectuer et son coût approximatif avant de soumettre vos documents à une tâche de traduction.

Demandez une estimation pour examiner le travail prévu ou l’utilisation probable avant de lancer la traduction. Le point de terminaison planifie le traitement des documents selon la configuration actuelle du moteur, sans créer de tâche ni exécuter le pipeline.

Demander une estimation #

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

Utilisez les mêmes champs engineId, sourceLocale, targetLocales et documents que pour la création d’une tâche. Le JSON intégré, les adresses d’artefacts, les sources précédentes et les traductions précédentes sont pris en charge. Omettez les options réservées aux tâches, comme 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 requête accepte au maximum 100 documents et 100 langues cibles distinctes, en tenant compte des paramètres spécifiques à chaque document. La planification est également limitée à 25 Mio de données d’entrée, 20 000 unités sources et 20 000 traductions en attente. Pour les volumes plus importants, répartissez le travail entre plusieurs estimations plus petites. EstimateTooLarge indique la limite dépassée ; EstimateDocumentInvalid signale un document qui ne peut pas être analysé ou aligné.

Fournir les fichiers manquants #

Une réponse HTTP 200 peut renvoyer "_tag": "MissingArtifacts" avec un tableau uploads. Pour chaque adresse, téléversez les octets d’origine vers le uploadUrl renvoyé à l’aide d’un PUT authentifié, puis renvoyez la demande d’estimation. Ces téléversements concernent les artefacts de l’organisation ; aucune tâche n’est créée.

Si les données d’entrée sont uniquement fournies sous forme intégrée, l’estimation lit directement le JSON transmis. Le contenu est tout de même envoyé à Lingo.dev : il ne s’agit pas d’une vérification hors ligne.

Lire l’estimation #

Une réponse à l’état prêt contient "_tag": "Estimated" et approximate: true :

ChampSignification
workNombre de sourceUnits, de pendingTranslations et de reusedTranslations.
totalsNombre total de jetons et coût total prévus.
conditionalProvisions distinctes pour le travail dépendant de résultats ultérieurs.
byLocaleTraductions en attente et réutilisées, coûts prévus et coûts conditionnels pour chaque langue cible.
stagesÉtape, langue facultative (null pour le travail partagé), indicateur de conditionnalité, nombre d’unités et de requêtes, et coût estimé.
exclusionsTravail sans tarif défini, comme externalHumanReview.
warningsLimites et hypothèses applicables à cette estimation.

Chaque objet de coût contient inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd et totalCostUsd. totalCostUsd exclut les dépenses BYOK facturées directement par le fournisseur, les provisions conditionnelles et les frais externes de relecture humaine. Examinez ces éléments séparément lorsque vous planifiez le workflow.

Les montants correspondent à une estimation des frais d’utilisation avant application des quotas inclus dans le forfait. Ils ne constituent ni une facture, ni un plafond de dépenses, ni une limite supérieure garantie. Le travail partagé à l’étape source peut apparaître avec locale: null ; la somme des seules lignes par langue ne correspond donc pas nécessairement au total de la tâche.

Après avoir examiné le plan, créez et démarrez une tâche avec la révision de la source et les options souhaitées. L’estimation ne réserve ni le travail ni les tarifs ; toute modification de la source, des consignes, des modèles ou des paramètres du pipeline peut modifier le travail finalement effectué.