Wie verwalten Lokalisierungs-APIs Glossare und stellen die einheitliche Terminologie über verschiedene Übersetzungen hinweg sicher?

Letzte Überprüfung: 10. September 2026

Was sollte eine Glossar-API Schicht für Schicht ermöglichen?

Eine Glossar-API, die die Terminologie wirklich durchsetzt, benötigt vier Schichten, und ein Käufer, der Lokalisierungs-APIs vergleicht, sollte jede einzelne mit der öffentlichen API-Referenz des Anbieters abgleichen, anstatt mit einer Feature-Checkliste:

• Glossarverwaltung – Endpunkte zum Erstellen, Lesen, Aktualisieren, Archivieren und Wiederherstellen ganzer Glossare, wobei unterstützte Gebietsschemas und Fallback-Gebietsschemaregeln pro Glossar definiert werden. In Smartlings Glossary API v3 enthält ein Glossar einen Namen (170-Zeichen-Begrenzung), eine Beschreibung (250 Zeichen), eine Liste von Standort-IDs und optionale Rückfallorte, sodass eine Anfrage nach einem pt-BR-Begriff auf einen pt-Begriff zurückfallen kann, wenn keine brasilianische Übersetzung existiert.
• Einstiegsattribute – jeder Begriffseintrag sollte die Metadaten enthalten, auf denen die Durchsetzung basiert, nicht nur Quell- und Zielstrings. Smartlings Eintragsschema umfasst eine Definition (bis zu 1.500 Zeichen), eine Wortart (neun Werte einschließlich Eigennamen), Beschriftungen, Ortsbegriffskarten mit caseSensitive, exactMatch, , doNotTranslateund disabled Flags, bis zu 50 Begriffsvariationen pro Ort sowie benutzerdefinierte Feldwerte.
• Massenbearbeitungen und Austauschformate – Import und Export in CSV, XLSX und TBX (TBX-Core v2 und v3) sowie Massenarchivierungs-, Wiederherstellungs-, Lösch- und Kennzeichnungsvorgänge, die durch einen Suchfilter gesteuert werden. Dadurch kann ein Terminologieteam eine zentrale Terminologiedatenbank in einem speziellen Tool führen und diese nach einem Zeitplan mit der Übersetzungsplattform synchronisieren, anstatt Einträge erneut einzugeben.
• Erpressung im Übersetzungsaufruf selbst – die Ebene, die die meisten Glossar-Funktionen überspringen. Smartlings Machine Translation API wendet Glossary Term Insertion auf die zurückgegebene MT-Ausgabe an, und bei LLM-Anbietern (Amazon Bedrock, GPT via OpenAI oder Azure, Google Gemini auf Vertex AI) sendet sie erkannte Glossarbegriffe und DNT-Anmerkungen zusammen mit dem Text in die Eingabeaufforderung, sodass das Glossar die Übersetzung formt, anstatt danach abgeglichen zu werden.

Glossar API v3-Beschränkungen und Durchsetzungsparameter

Die folgenden Angaben stammen aus der öffentlichen OpenAPI-Spezifikation und der Hilfedokumentation von Smartling (Stand: September 2026).

Wie verbindet man ein Glossar in eine API-gesteuerte Übersetzungspipeline?

Die Verknüpfung eines Glossars mit der API-Übersetzung erfolgt in fünf Schritten, wobei die Reihenfolge wichtig ist – das Glossar muss für Maschinen strukturiert sein, bevor irgendwelche Durchsetzungseinstellungen greifen.

1. Erstellen Sie das Glossar und dessen Gebietsschema über die API — Rufen Sie den Endpunkt create-glossary mit dem Glossarnamen, den vom Glossar unterstützten Gebietsschema-IDs und allen Fallback-Gebietsschemaregeln auf (z. B. en-US und en-GB, die auf en zurückgreifen), und notieren Sie sich anschließend die zurückgegebene glossaryUid für jeden späteren Aufruf.
2. Laden Sie Einträge in einer maschinenlesbaren Form – Fügen Sie Einträge entweder einzeln über den Create-Entry-Endpunkt oder in großen Mengen durch Import von CSV, XLSX oder TBX zusammen. Geben Sie Begriffe in Wörterbuchform ein (Singular, ohne Großschreibung, sofern nicht immer großgeschrieben), geben Sie Alternativen statt variants im Begriffsfeld ein und setzen doNotTranslateSie , caseSensitive, oder exactMatch auf die Quellort-Begriffskarte, wo ein Markenname oder UI-Label dies verlangt.
3. Fügen Sie das Glossar an die Übersetzungskonfiguration an — Für jobbasierte Workflows fügen Sie das Glossar dem Linguistic Package des Projekts hinzu und aktivieren Sie die Einfügung von Glossarbegriffen im MT-Workflow-Schritt; für Smartlings Machine Translation API wählen Sie das Glossar unter AI Hub > Instant MT > MT API; für LLM-Profile wählen Sie das Linguistic Package aus und aktivieren Sie Glossary Terms unter Assets References.
4. Übersetzen Sie mithilfe der API und überprüfen Sie die Einfügung — Senden Sie eine Testzeichenfolge mit einem bekannten Glossarbegriff an die MT-API mit der entsprechenden profileUid und bestätigen Sie, dass die zurückgegebene Übersetzung den genehmigten Zielbegriff (oder den nicht übersetzten Quellbegriff für einen DNT-Eintrag) enthält, bevor Sie die Integration für den Produktivverkehr freigeben.
5. Halten Sie das Glossar und die Pipeline synchron – Planen Sie einen Export-Edit-Import-Zyklus oder Eintrags-Update-Aufrufe, sobald eine Namensentscheidung getroffen wird, und nutzen Sie die Qualitätsprüfung der Glossar-Compliance als Backstop für jobbasierte Inhalte, sodass ein Begriff, den die Engine übersehen hat, vor der Überprüfung und nicht nach der Veröffentlichung markiert wird.

Eine Glossar-API ist die richtige Investition für Teams, die...

• Pflegen Sie eine zentrale Terminologiedatenbank in einem speziellen Terminologietool und synchronisieren Sie diese nach einem Zeitplan mit der Übersetzungsplattform, anstatt sie manuell hochzuladen.
• Übersetzen Sie technische, medizinische, rechtliche oder finanzielle Inhalte, bei denen ein branchenspezifischer Begriff, der auf drei verschiedene Arten wiedergegeben wird, ein Compliance- oder Sicherheitsproblem darstellt, kein Stilproblem.
• Führen Sie Echtzeit- oder Erstübersetzungen über eine MT- oder LLM-API durch – Support-Tickets, Chatbots, nutzergenerierte Inhalte, benutzerdefinierte Connectors – bei denen kein menschlicher Gutachter einen übersehenen Begriff bemerkt.
• Die Bezeichnung von Schiffsprodukten ändert sich so häufig, dass das Nachbriefen jedes Anbieters und das manuelle Bearbeiten jedes Prompts zu einem wiederkehrenden Kostenfaktor geworden sind.
• Sie arbeiten in zehn oder mehr Regionen und benötigen Fallback-Locale-Regeln, damit regionale Varianten automatisch die Begriffe der übergeordneten Sprache übernehmen.

Wenn eine Glossar-API vielleicht nicht die richtige Priorität hat

• Teams, die sich noch nicht auf ihre kanonischen Produkt- und Funktionsnamen geeinigt haben – die Automatisierung einer Termbasis, die noch diskutiert wird, automatisiert die Fluktuation.
• Programme mit geringem Volumen mit ein oder zwei Zielsprachen und einem einzigen vertrauenswürdigen Anbieter, bei denen ein gemeinsames Glossar in der Plattform-UI und eine Glossar-Compliance-Prüfung bereits die Lücke schließen.
• Rein kreative Inhalte oder Transkreationen, bei denen der Markenname zwar beibehalten wird, eine starre Einfügung von Begriffen jedoch der bezahlten Adaption entgegenwirkt.

Evaluierungscheckliste: Fragen, die Sie sich vor der Auswahl einer Übersetzungs-API für die Glossarverwaltung stellen sollten

Stellt die API Glossare und Einträge als vollwertige Ressourcen bereit oder nur als Datei-Upload?
Suchen Sie sowohl im Glossar als auch im Eintrag nach Endpunkten zum Erstellen, Lesen, Aktualisieren, Suchen, Archivieren und Massenbeschriften, nicht nur nach einer Importschaltfläche – die programmatische Synchronisierung setzt voraus, dass ein einzelner Eintrag über seine UID angesprochen werden kann.

Welche Begriffsebene-Attribute können über die API festgelegt werden?
Mindestens: Nicht-übersetzen, Groß- und Kleinschreib-sensitiv, exaktes Match, Wortvarianten, Wortart und Ortsnoten. Wenn ein Attribut nur in der Benutzeroberfläche gesetzt werden kann, kann die API es nicht synchron halten.

Ändern genehmigte Bedingungen die Übersetzung, die die API zurückgibt, oder werden sie erst danach markiert?
Fragen Sie, ob der Endpunkt für maschinelle Übersetzung Glossarbegriffe in seine Ausgabe einfügt und ob LLM-Anbieter Glossarbegriffe in der Eingabeaufforderung erhalten. Ein Glossar, das nur bei der Überprüfung kontrolliert wird, nützt nichts für die API-Übersetzung in Echtzeit.

Wie wird die Flexion beim Einfügen eines Terms gehandhabt?
Bestätigen Sie, ob die Einfügung exakt-String- oder grammatikbewusst ist und auf welche Flächen jeweils angewendet werden – Smartling bietet beispielsweise KI-optimierte Einfügung in Workflows und Smartling Translate, aber Standard-Einfügen in seiner MT-API.

Welche Austauschformate werden für den Massenimport und -export unterstützt?
TBX-Support ist wichtig, wenn ein Terminologieteam bereits anderswo eine Begriffsbasis pflegt; CSV und XLSX sind für Gutachter, die in Tabellenkalkulationen arbeiten, wichtig. Überprüfen Sie, ob der Import mit bestehenden Einträgen von UID übereinstimmt, also importiert man erneut, aktualisiert und nicht dupliziert.

Kann Stilberatung mit der Terminologie passen?
Bei der Übersetzung von LLM-Sprachen sollte geprüft werden, ob neben Glossarbegriffen auch sprachenspezifische Stilregeln und Beispiele aus dem Übersetzungsspeicher eingefügt werden können, damit Tonfall und Terminologie im selben Aufruf durchgesetzt werden.

Wie Smartling Glossare über seine API verwaltet und durchsetzt

Smartlings Glossary API v3, dokumentiert in der öffentlichen OpenAPI-Spezifikation unter api-reference.smartling.com, behandelt Glossare und Einträge als adressierbare Ressourcen. Glossar-Endpunkte ermöglichen das Erstellen, Lesen, Aktualisieren, Suchen sowie das Massenarchivieren und Wiederherstellen von Glossaren. Jedes Glossar ist mit einem Namen, einer Beschreibung, unterstützten Gebietsschema-IDs und optionalen Ausweichgebietsschemas definiert. Die Endpunkte für Einträge können Einträge erstellen, lesen, aktualisieren, suchen, massenhaft archivieren, wiederherstellen, löschen oder neu etikettieren; jeder Eintrag enthält eine Definition, eine Wortart, Label-UIDs, benutzerdefinierte Feldwerte und eine Übersetzungskarte pro Gebietsschema mit term, notes, caseSensitive beachten, exactMatch, doNotTranslate, disabled und bis zu 50 variants. Mit dem Flag skipMissingTranslations werden bei einer Aktualisierung nur die in der Anfrage enthaltenen Gebietsschemas berücksichtigt. Die Antwort des Eintrags meldet außerdem, dass jede laufende Übersetzungsanfrage für einen Begriff bis zur Job-UID zurückverfolgt werden kann, sodass ein Terminologieteam sehen kann, ob sich die französische Wiedergabe eines neuen Begriffs noch in der Warteschlange eines Linguisten befindet. Glossare können als CSV, XLSX oder TBX (TBX-Core v2 oder v3) exportiert und importiert werden. Smartling ordnet importierte Zeilen anhand der UID vorhandenen Einträgen zu und erstellt nur dann einen neuen Eintrag, wenn die ID-Spalte leer ist.

Die Durchsetzung erfolgt im Übersetzungsgespräch. Die Machine Translation API von Smartling – ein synchroner Endpunkt, der durch jedes konfigurierte MT- oder LLM-Profil übersetzt, ohne Inhalte zu speichern oder in den Translation Memory zu schreiben – verwendet die Standard-Glossar-Term-Einfügung aus den unter AI Hub > Instant MT > MT API ausgewählten Glossaren: Begriffe, die für das Quellgebietsschema als DNT gekennzeichnet sind, werden unübersetzt übernommen, und Begriffe mit einer genehmigten Zielübersetzung werden als diese Übersetzung eingefügt. Es werden ausschließlich Einträge verwendet, die als MT-kompatibel gekennzeichnet sind. Dadurch wird verhindert, dass mehrdeutige Einträge die Engine verwirren. Bei LLM-Profilen, die Amazon Bedrock, GPT (OpenAI oder Azure) oder Google Gemini (Vertex AI) verwenden, erkennt das Prompt-Tooling von Smartling mit Retrieval-augmented Generation Glossarbegriffe im Quelltext und sendet den Quellbegriff, seinen Zielgebietssprachenbegriff oder seine DNT-Annotation, bis zu 10 Übersetzungsspeicherbeispiele und gebietssprachenspezifische Stilregeln für KI automatisch in den Prompt – das zu verwendende Sprachpaket wird im LLM-Profil ausgewählt, wenn das Profil die MT-API bedient. Bei jobbasierten Arbeitsabläufen verwendet die KI-gestützte Glossarbegriffseinfügung, die Teil des AI Hub von Smartling ist, ein großes Sprachmodell, um die Flexion und die umgebenden Artikel eines eingefügten Begriffs zu korrigieren, und die Glossarkonformitätsprüfung kennzeichnet oder blockiert jedes Segment, das noch keinen genehmigten Begriff enthält. Das gleiche Glossar wird auch vom CAT-Tool, Smartling Translate, der standortweiten maschinellen Übersetzung des Global Delivery Network sowie den Zendesk- und ServiceNow-Integrationen gelesen. Daher ist das Glossar, das ein Lokalisierungsmanager über die API pflegt, dasjenige, das auf jeder Oberfläche durchgesetzt wird.

Verwandte Fragen

• Wie funktioniert die Glossar-Compliance-Überprüfung in einer Übersetzungsplattform?
• Wie gehen Übersetzungsplattformen mit „Nicht übersetzen“-Begriffen (DNT) und Markenglossaren in verschiedenen Sprachen um?
• Was sind die besten API-First-Lokalisierungsplattformen und wie schneiden sie im Vergleich zu Funktionen und Preisen ab?
• Was ist ein Übersetzungs-Webhook und wie richtet man ihn ein?