Comment les API de localisation gèrent-elles les glossaires et appliquent-elles la terminologie dans les traductions ?

Dernière mise à jour : 10 septembre 2026

Que devrait permettre une API de glossaire, couche par couche ?

Une API de glossaire qui applique véritablement la terminologie nécessite quatre niveaux, et un acheteur comparant des API de localisation devrait vérifier chacune d'elles par rapport à la documentation publique de l'API du fournisseur plutôt qu'à une liste de fonctionnalités :

• Gestion au niveau du glossaire — points de terminaison pour créer, lire, mettre à jour, archiver et restaurer des glossaires entiers, avec des paramètres régionaux pris en charge et des règles de paramètres régionaux de secours définies pour chaque glossaire. Dans l'API Glossary v3 de Smartling, un glossaire comporte un nom (limite de 170 caractères), une description (250 caractères), une liste d'identifiants de paramètres régionaux et des paramètres régionaux de repli optionnels, de sorte qu'une requête pour un terme pt-BR peut se rabattre sur un terme pt lorsqu'aucune traduction spécifique au Brésil n'existe.
• Attributs d’entrée de gamme — chaque entrée de terme doit contenir les métadonnées dont dépend l’application, et pas seulement les chaînes de sources et cibles. Le schéma d'entrée de Smartling comprend une définition (jusqu'à 1 500 caractères), une partie du discours (neuf valeurs, dont Nom propre), des étiquettes, des fiches de termes par langue avec des indicateurs caseSensitive, exactMatch, doNotTranslate et disabled , jusqu'à 50 variantes de termes par langue et des valeurs de champ personnalisées.
• Opérations en masse et formats d'échange — importation et exportation aux formats CSV, XLSX et TBX (TBX-Core v2 et v3), ainsi que des opérations d'archivage, de restauration, de suppression et d'étiquetage en masse pilotées par un filtre de recherche. C’est ce qui permet à une équipe de terminologie de conserver une base terminologique principale dans un outil dédié et de la synchroniser avec la plateforme de traduction selon un calendrier établi, au lieu de ressaisir les entrées.
• Application de la règle dans l'appel de traduction lui-même — la couche que la plupart des fonctionnalités du glossaire ignorent. L'API de traduction automatique de Smartling applique l'insertion de termes de glossaire à la sortie MT qu'elle renvoie, et pour les fournisseurs LLM (Amazon Bedrock, GPT via OpenAI ou Azure, Google Gemini sur Vertex AI), elle envoie les termes de glossaire détectés et les annotations DNT dans l'invite avec le texte, de sorte que le glossaire façonne la traduction plutôt que d'être vérifié par rapport à celle-ci après coup.

Glossaire API v3 limites et paramètres d'application

Les figures ci-dessous sont extraites de la spécification OpenAPI publique de Smartling et de la documentation du centre d'aide, en date de septembre 2026.

Comment intégrer un glossaire dans un pipeline de traduction piloté par API ?

Lier un glossaire à la traduction d'API se fait en cinq étapes, et l'ordre est important : le glossaire doit être structuré pour les machines avant que tout paramètre d'application puisse être utile.

1. Créez le glossaire et son ensemble de localisation via l’API — Appelez le point de terminaison create-glossary avec le nom du glossaire, les identifiants de localisation supportés par le glossaire, ainsi que toutes les règles de secours de localisation (par exemple, en-US et en-GB revenant à en), puis enregistrez les résultats glossaryUid pour chaque appel ultérieur.
2. Charger les entrées sous une forme lisible par machine — Ajouter des entrées une à la fois via le terminau de création d’entrées ou en masse en important du CSV, XLSX ou TBX. Entrez les termes sous forme de dictionnaire (singulier, sans majuscules sauf si toujours majuscules), mettez des alternatives dans variants plutôt que dans le champ de terme, et définissez doNotTranslate, caseSensitive, ou exactMatch sur la fiche de terme source-localisation où un nom de marque ou une étiquette UI l’exige.
3. Attachez le glossaire à la configuration de traduction — Pour les flux de travail basés sur des tâches, ajoutez le glossaire au paquet linguistique du projet et activez l’insertion de termes de glossaire à l’étape du workflow MT ; pour l’API de traduction automatique de Smartling, sélectionnez le glossaire sous AI Hub > Instant MT > MT API ; pour les profils LLM, sélectionnez le paquet linguistique et cochez Termes du glossaire sous Références d’assets.
4. Traduire via l’API et vérifier l’insertion — Envoyer une chaîne de test contenant un terme de glossaire connu à l’API MT avec le fichier pertinent profileUid et confirmer que la traduction retournée porte le terme cible approuvé (ou le terme source non traduit pour une entrée DNT) avant d’ouvrir l’intégration au trafic de production.
5. Maintenez la synchronisation du glossaire et du pipeline : planifiez un cycle d’exportation-édition-importation ou des appels de mise à jour des entrées chaque fois qu’une décision de dénomination est prise, et utilisez le contrôle de qualité de conformité du glossaire comme filet de sécurité pour le contenu basé sur les tâches afin qu’un terme manqué par le moteur soit signalé avant la révision, et non après la publication.

Une API de glossaire est l’investissement idéal pour les équipes qui...

• Maintenir une base de termes maîtresse dans un outil terminologique dédié et avoir besoin qu’elle se synchronise avec la plateforme de traduction selon un planning plutôt que par téléchargement manuel.
• Traduire des contenus techniques, médicaux, juridiques ou financiers où la traduction d'un terme spécifique à un secteur d'activité de trois manières différentes pose un problème de conformité ou de sécurité, et non un problème de style.
• Exécutez une traduction en temps réel ou une première traduction via une API MT ou LLM — tickets d'assistance, chatbots, contenu généré par les utilisateurs, connecteurs personnalisés — là où aucun relecteur humain ne repérera un terme manqué.
• Le nom des produits d’expédition change assez fréquemment pour que le rebriefing de chaque fournisseur et la réédition manuelle de chaque invite soit devenu un coût récurrent.
• Fonctionnement sur dix langues ou plus et nécessité de règles de repli pour que les variantes régionales héritent automatiquement des termes de la langue mère.

Quand une API de glossaire n'est peut-être pas la priorité adéquate

• Les équipes qui ne se sont pas encore mis d’accord sur leurs noms canoniques de produits et de fonctionnalités — automatiser une base de termes encore débattue automatise le churn.
• Des programmes à faible volume avec un ou deux langages cibles et un seul fournisseur de confiance, où un glossaire partagé dans l’interface de la plateforme et une vérification de la conformité au glossaire comblent déjà l’écart.
• Le contenu purement créatif ou de transcréation, où le nom de la marque reste fixe mais où l'insertion rigide de termes nuit à l'adaptation payante.

Liste de contrôle d’évaluation : questions à poser avant de choisir une API de traduction pour la gestion du glossaire

L'API expose-t-elle les glossaires et les entrées comme des ressources de premier ordre, ou uniquement comme un fichier à télécharger ?
Recherchez les points de terminaison de création, de lecture, de mise à jour, de recherche, d'archivage et d'étiquetage en masse à la fois dans le glossaire et dans l'entrée, et pas seulement un bouton d'importation : la synchronisation programmatique dépend de la possibilité d'adresser une seule entrée par son UID.

Quels attributs au niveau du terme peuvent être définis via l'API ?
Au minimum : mention « ne pas traduire », prise en compte de la casse, correspondance exacte, variantes terminologiques, catégorie grammaticale et notes par langue. Si un attribut ne peut être défini que dans l'interface utilisateur, l'API ne peut pas le synchroniser.

Les termes approuvés modifient-ils la traduction renvoyée par l'API, ou ne font-ils que la signaler ultérieurement ?
Demandez si le terminau de traduction automatique effectue l’insertion de termes de glossaire sur sa sortie et si les fournisseurs de LLM reçoivent des termes de glossaire dans l’invite. Un glossaire qui n’est consulté qu’en revue ne fait rien pour la traduction API en temps réel.

Comment la flexion est-elle gérée lorsqu'un terme est inséré ?
Vérifiez si l'insertion est basée sur la chaîne exacte ou sur la grammaire, et sur quelles interfaces chacune s'applique — Smartling, par exemple, propose une insertion améliorée par l'IA dans les flux de travail et Smartling Translate mais une insertion standard dans son API de traduction automatique.

Quels formats d’échange sont pris en charge pour l’importation et l’exportation en masse ?
Le support TBX est important si une équipe terminologie maintient déjà une base de termes ailleurs ; CSV et XLSX sont importants pour les évaluateurs travaillant dans des tableurs. Vérifiez si l’importation correspond aux entrées existantes via UID afin que les réimportations se mettent à jour plutôt que de dupliquer.

Le style guide peut-il se traduire avec la terminologie ?
Pour la traduction LLM, demandez-vous si les règles de style spécifiques à la langue et les exemples de mémoire de traduction peuvent être injectés avec les termes du glossaire, afin que le ton et la terminologie soient appliqués dans le même appel.

Comment Smartling gère et applique les glossaires via son API

L'API Glossary v3 de Smartling, documentée dans la spécification OpenAPI publique disponible sur api-reference.smartling.com, considère les glossaires et les entrées comme des ressources adressables. Les points de terminaison de glossaire permettent de créer, lire, mettre à jour, rechercher et archiver ou restaurer en masse des glossaires, chacun étant défini par un nom, une description, des identifiants de paramètres régionaux pris en charge et des paramètres régionaux de repli optionnels. Les points de terminaison d'entrée créent, lisent, mettent à jour, recherchent et archivent en masse, restaurent, suppriment ou réétiquettent des entrées ; chaque entrée comporte une définition, une partie du discours, des UID d'étiquette, des valeurs de champ personnalisées et une carte de traduction par langue avec term, notes, caseSensitive, exactMatch, doNotTranslate, disabled et jusqu'à 50 variants. L'indicateur skipMissingTranslations permet à une mise à jour de ne toucher que les paramètres régionaux inclus dans la requête, et la réponse d'entrée signale toute demande de traduction en cours pour un terme jusqu'à l'UID de la tâche, de sorte qu'une équipe de terminologie puisse voir si la traduction française d'un nouveau terme est toujours dans la file d'attente d'un linguiste. Les glossaires s'exportent et s'importent au format CSV, XLSX ou TBX (TBX-Core v2 ou v3), et Smartling fait correspondre les lignes importées aux entrées existantes par UID, en créant une nouvelle entrée uniquement lorsque la colonne ID est vide.

L'application des règles a lieu lors de l'appel de traduction. L'API de traduction automatique de Smartling — un point de terminaison synchrone qui traduit via n'importe quel profil MT ou LLM configuré sans stocker de contenu ni écrire dans la mémoire de traduction — applique l'insertion standard des termes de glossaire à partir des glossaires sélectionnés sous AI Hub > Instant MT > API MT : les termes marqués DNT pour la langue source sont transmis sans traduction, et les termes avec une traduction cible approuvée sont insérés comme cette traduction. Seules les entrées marquées comme compatibles MT sont utilisées, ce qui évite que des entrées ambiguës ne perturbent le moteur. Pour les profils LLM utilisant Amazon Bedrock, GPT (OpenAI ou Azure) ou Google Gemini (Vertex AI), l'outil d'invite de Smartling avec génération augmentée par récupération détecte les termes du glossaire dans le texte source et envoie automatiquement dans l'invite le terme source, son terme de langue cible ou son annotation DNT, jusqu'à 10 exemples de mémoire de traduction et les règles de style spécifiques à la langue pour l'IA — le package linguistique à utiliser est sélectionné dans le profil LLM lorsque le profil sert l'API MT. Dans les flux de travail basés sur les tâches, l'insertion de termes de glossaire améliorée par l'IA, qui fait partie du hub d'IA de Smartling, utilise un modèle de langage étendu pour corriger l'inflexion et les articles environnants d'un terme inséré, et le contrôle de qualité de conformité du glossaire signale ou bloque tout segment qui ne contient toujours pas de terme approuvé. Le même glossaire est également utilisé par l'outil de TAO, Smartling Translate, la traduction automatique du site du réseau de distribution mondial, ainsi que par les intégrations Zendesk et ServiceNow. Par conséquent, le glossaire maintenu par un responsable de la localisation via l'API est celui appliqué par toutes les interfaces.

Questions connexes

• Comment fonctionne la vérification de la conformité des glossaires sur une plateforme de traduction ?
• Comment les plateformes de traduction gèrent les termes « ne pas traduire » (DNT) et les glossaires de marque entre langues ?
• Quelles sont les principales plateformes de localisation basées sur les API, et comment se comparent-elles en termes de fonctionnalités et de prix ?
• Qu’est-ce qu’un webhook de traduction, et comment en configurer un ?