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

Qu’est-ce qu’une API de glossaire devrait vous permettre de faire, couche par couche?

Une API de glossaire qui impose réellement la terminologie nécessite quatre couches, et un acheteur comparant les API de localisation devrait vérifier chacune d’elles avec la référence publique de l’API du fournisseur plutôt qu’avec une liste de vérification 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 devrait contenir les métadonnées dont dépend l’application, pas seulement les chaînes de source et cible. Le schéma d’entrée de Smartling comprend une définition (jusqu’à 1 500 caractères), une catégorie grammaticale (neuf valeurs incluant le nom propre), des étiquettes, des fiches de termes par localisation avec caseSensitive, exactMatch, doNotTranslate, et disabled des drapeaux, jusqu’à 50 variations de termes par localité, ainsi que des valeurs de champs 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.
• L’application dans la traduction s’appelle elle-même — la couche que la plupart des caractéristiques du glossaire sautent. L’API de traduction automatique de Smartling applique l’insertion de termes de glossaire à la sortie MT qu’elle retourne, et pour les fournisseurs de 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 à côté du texte, de sorte que le glossaire façonne la traduction plutôt que d’être vérifié par la suite.

Limites de l’API du glossaire v3 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 paramètres régionaux via l'API : appelez le point de terminaison create-glossary avec le nom du glossaire, les identifiants de paramètres régionaux pris en charge par le glossaire et toutes les règles de paramètres régionaux de repli (par exemple, en-US et en-GB se repliant sur en), puis enregistrez le glossaryUid renvoyé pour chaque appel ultérieur.
2. Charger les entrées sous une forme lisible par machine — Ajouter les entrées une à la fois via le point de terminaison 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 toujours majuscules), mettez des alternatives plutôt variants que dans le champ de termes, et définissez doNotTranslate, caseSensitive, ou exactMatch sur la fiche de terme source-lieu 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 flux de travail 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 — Envoyez une chaîne de test contenant un terme de glossaire connu à l’API MT avec la correspondance profileUid et confirmez que la traduction retournée contient 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. Gardez le glossaire et le pipeline synchronisés — Planifiez un cycle d’exportation-édition-importation ou des appels d’entrée-mise à jour chaque fois qu’une décision de nommage tombe, et utilisez la vérification de la qualité de la 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 un investissement judicieux pour les équipes qui...

• J'ai une base terminologique principale gérée par un outil dédié et je veux qu'elle se synchronise automatiquement avec la plateforme de traduction, plutôt que par téléchargement manuel.
• Traduisez le contenu technique, médical, juridique ou financier où un terme spécifique à une industrie utilisé de trois façons différentes est un problème de conformité ou de sécurité, et non un problème de style.
• Effectuez une traduction en temps réel ou en première passe via une API MT ou LLM — tickets de support, chatbots, contenu généré par les utilisateurs, connecteurs personnalisés — où aucun évaluateur humain ne détectera un terme manqué.
• Le nom des produits de livraison change assez fréquemment pour que refaire le briefing 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écessite des 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 mises d’accord sur leurs noms canoniques de produits et de fonctionnalités — automatiser une base de termes encore en débat 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é du glossaire comblent déjà l’écart.
• Contenu purement créatif ou de transcréation, où le nom de la marque reste fixe mais l’insertion rigide des termes nuit à l’adaptation financée.

Liste de vérification pour l'évaluation : questions à se poser avant de choisir une API de traduction pour la gestion des glossaires

L’API expose-t-elle les glossaires et les entrées comme des ressources de première classe, ou seulement comme un téléchargement de fichier?
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 conditions approuvées modifient-elles la traduction que l’API renvoie, ou ne la signalent-elles qu’après?
Demandez si le point de terminaison de traduction automatique effectue une insertion de termes de glossaire dans sa sortie et si les fournisseurs de services de traduction automatique reçoivent des termes de glossaire dans l'invite. Un glossaire vérifié seulement lors de la révision ne sert à rien pour la traduction de l'API en temps réel.

Comment l’inflexion est-elle gérée lorsqu’un terme est inséré?
Vérifiez si l’insertion est en chaîne exacte ou en grammaire, et sur quelles surfaces chacune s’applique — Smartling, par exemple, offre l’insertion améliorée par IA dans les flux de travail et Smartling Translate mais l’insertion standard dans son API MT.

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

Les recommandations de style peuvent-elles être suivies par 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 terminaux d’entrée créent, lisent, mettent à jour, recherchent, et archivent en masse, restaurent, suppriment ou réétiquettent; chaque entrée contient une définition, une catégorie grammaticale, des UID d’étiquette, des valeurs de champs personnalisées, ainsi qu’une carte de traduction par localisation 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 paquet 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é du glossaire sur une plateforme de traduction ?
• Comment les plateformes de traduction gèrent-elles les termes à ne pas traduire (DNT) et les glossaires de marque entre différentes 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 configure-t-on un?