Which localization APIs offer the most robust glossary management and compare how they enforce terms across translations?

A glossary API is the part of a localization platform's API that lets a team create glossaries, add and update term entries, import and export term files, and have approved terms applied automatically when content is machine- or LLM-translated. Smartling exposes glossary management through its Glossary API v3 (glossaries, entries, labels, CSV/XLSX/TBX import and export) and enforces those terms in API-driven translation through Glossary Term Insertion in its Machine Translation API and glossary injection into LLM prompts.

Hur hanterar API:er för lokalisering ordlistor och tillämpar terminologi över översättningar?

Ett API för ordlistor är den del av en lokaliseringsplattforms API som gör det möjligt för ett team att skapa ordlistor, lägga till och uppdatera termposter, importera och exportera termfiler och få godkända termer tillämpas automatiskt när innehåll översätts maskin- eller LLM-översätts via samma API. Smartling avslöjar ordlisthantering genom sin Glossary API v3 — ordlista och post CRUD, etiketthantering, sökning och CSV-, XLSX- och TBX-import/export — och verkställer dessa termer i API-driven översättning genom Glossary Term Insertion i dess Machine Translation API och genom att injicera upptäckta ordlistor i LLM-översättningsanvisningar. För en lokaliseringshanterare är det praktiska testet av en " robust " ordlista API inte om termer kan lagras, utan om en term som läggs till via API:et ändrar översättningen som API:et returnerar.

Varför glider terminologin även när ett team har en ordlista?

Terminologin försvinner när ordlistan finns någonstans översättningsmotorn aldrig läser. Fem mönster står för det mesta:

Ordlistan är en fil, inte en tjänst. Ett kalkylblad eller PDF-termlista har inget API, så varje nytt produktnamn måste skickas om till varje leverantör och klistras in i varje prompt för hand, och kopiorna avviker inom några veckor.
Maskinöversättning körs utan terminsättning. Ett rått MT- eller LLM-samtal har ingen kunskap om ett företags godkända franska för " sekretesspolicy "; såvida inte plattformen infogar den godkända termen eller skickar den till prompten väljer motorn sin egen rendering varje gång.
Inlägg är inte maskinläsbara. Ett termkort som lagrar tre alternativ åtskilda med snedstreck (" konto/profil/post ") läses som en term på 22 tecken med infogningslogik, så ingenting matchar och ingenting infogas.
Böjning bryter exakt-strängverkställighet. Ett godkänt singulärt substantiv som infogas ordagrant i en tysk eller polsk mening ger fel skiftlägesändelse, så granskare " fixar " tillbaka det till en icke godkänd form.
Uppdateringar av ordlistor och översättningsjobb synkroniseras inte. Nya termer godkänns i en namngranskning men når ordlistan efter att nästa utgåvs strängar redan har översatts, så utgåvan levereras med den gamla termen och ordlistan kommer ikapp en sprint senare.

Vad ska ett ordlistnings-API låta dig göra, lager för lager?

Ett ordlistnings-API som verkligen upprätthåller terminologi behöver fyra lager, och en köpare som jämför lokaliserings-API:er bör kontrollera var och en mot leverantörens offentliga API-referens snarare än en funktionschecklista:

Hantering på ordlistnivå — slut punkter för att skapa, läsa, uppdatera, arkivera och återställa hela ordlistor, med stödda språk och fallback-regler definierade per ordlista. I Smartlings Glossary API v3 har en ordlista ett namn (gräns på 170 tecken), en beskrivning (250 tecken), en lista med lokal-ID och valfria fallback-språk, så en begäran om en pt-BR-term kan falla tillbaka till en pt-term när det inte finns någon brasiliansk specifik översättning.
Attribut på startnivå — varje termpost bör innehålla de metadata som verkställigheten beror på, inte bara källa- och målsträngar. Smartlings inmatningsschema innehåller en definition (upp till 1 500 tecken), en del av talet (nio värden inklusive eget substantiv), etiketter, termkort per lokal med caseSensitive, ExactMatch, Do NotTranslate och inaktiver ade flaggor, upp till 50 termvariationer per språk och anpassade fältvärden.
Massoperationer och utbytesformat — import och export i CSV, XLSX och TBX (TBX-Core v2 och v3), plus massarkivering, återställning, radering och etikettering som drivs av ett sökfilter. Det är detta som gör det möjligt för ett terminologiteam att behålla en huvudtermbas i ett dedikerat verktyg och synkronisera den till översättningsplattformen enligt ett schema istället för att ange poster.
Verkställighet i själva översättningssamtalet - det lager som de flesta ordlistans funktioner hoppar över. Smartlings API för maskinöversättning tillämpar Glossary Term Insertion på MT-utdata som den returnerar, och för LLM-leverantörer (Amazon Bedrock, GPT via OpenAI eller Azure, Google Gemini på Vertex AI) skickar den upptäckta ordlistan och DNT-kommentarer till prompten bredvid texten, så ordlistan formar översättningen snarare än att kontrolleras mot den efteråt.

Ordlista API v3-gränser och verkställighetsparametrar

Siffrorna nedan är hämtade från Smartlings offentliga OpenAPI-specifikation och hjälpcenterdokumentation från september 2026.

Parameter	Värde	Varför det spelar roll
Ordlistans namn/ beskrivningslängd	170/250 tecken	Tillräckligt för att koda produktlinje, region och innehållstyp i namnet för programmatisk filtrering
Inmatningsdefinitionslängd	1 500 tecken	Plats för en fullständig teknisk definition som lingvister ser i CAT-verktyget, inte en ledtråd på en rad
Terminslängd per land	250 tecken	Omfattar tekniska fraser med flera ord och regleringsbeteckningar
Termvariationer per språk	50, vardera upp till 250 tecken	Alternativen finns här, inte snedstreckseparerade i termfältet, så insättningslogik kan matcha dem
Taldelsvärden	9 (substantiv, verb, adjektiv, adverb, pronomen, preposition, interjektion, konjunktion, egennamn)	Låter en termbas skilja " e-post " substantivet från " e-post " verbet, en känd felpunkt för AI-terminsättning
Import / export formats	CSV, XLSX, TBX (TBX-kärna v2 och v3)	TBX är ISO-terminologiutbytesstandarden, så en extern termbas kan rundresa utan en anpassad mappare
Exempel på översättningsminne som skickas till en LLM per sträng (RAG-promptverktyg)	Upp till 10	Ordlistor skickas tillsammans med dessa, så terminologi och stilexempel når modellen tillsammans
Ordlista Terminsättningstyp tillgänglig via MT API	Standard (AI-förbättrad finns i arbetsflöden och Smartling Translate)	Ställer förväntningar på böjningshantering på API-anrop i realtid kontra jobbbaserade arbetsflöden

Hur kopplar du en ordlista till en API-driven översättningspipeline?

Att ansluta en ordlista till API-översättning är en sekvens i fem steg, och ordningen är viktig - ordlistan måste struktureras för maskiner innan någon verkställighetsinställning hjälper.

Skapa ordlistan och dess språkinställningar via API :et — Anropa slutpunkten för skapa-ordlista med ordlistans namn, de språkliga ID:n som ordlistan stöder och eventuella reservregler (till exempel en-US och sv-GB som faller tillbaka till en) och registrera sedan det returnerade glossarYUID för varje senare anrop.
Ladda poster i en maskinläsbar form — Lägg till poster antingen en i taget genom slutpunkten för skapande post eller i bulk genom att importera CSV, XLSX eller TBX. Ange termer i ordboksform (singular, utan versaler om inte alltid versaler), lägg alternativ i varianter i stället för termfältet och ställ in do NotTranslate, CaseSensitive eller ExactMatch på källkods-språkkortet där ett varumärke eller användargränssnittsetikett kräver det.
Bif@@ oga ordlistan till översättningskonfigurationen — För jobbbaserade arbetsflöden lägger du till ordlistan i projektets språkpaket och aktiverar Ordlista Terminsättning i arbetsflödessteget MT. För Smartlings API för maskinöversättning väljer du ordlistan under AI Hub > Instant MT > MT API; för LLM-profiler väljer du Lingvistiska paketet och markerar Ordlista Termer under Tillgångsreferenser.
Översätt genom API:et och verifiera infogning — Skicka en teststräng som innehåller en känd ordlista till MT API med relevant ProfileUID och bekräfta att den returnerade översättningen innehåller den godkända måltermen (eller den oöversatta källtermen för en DNT-post) innan integrationen öppnas för produktionstrafik.
Håll ordlistan och pipelinen synkron iserade — Schemalägg en cykel för export, redigering och import eller inmatningsuppdateringssamtal när ett namnbeslut landar, och använd kvalitetskontrollen för ordlistans efterlevnad som en backstop för jobbbaserat innehåll så att en term som motorn missade flaggas före granskning, inte efter publicering.

Ett ordlistnings-API är rätt investering för team som...

Behåll en huvudtermbas i ett dedikerat terminologiverktyg och behöver att den synkroniseras med översättningsplattformen enligt ett schema snarare än genom manuell uppladdning.
Översätt tekniskt, medicinskt, juridiskt eller ekonomiskt innehåll där en branschspecifik term som återges på tre olika sätt är ett efterlevnads- eller säkerhetsproblem, inte ett stilproblem.
Kör realtids- eller förstapassöversättning via ett MT- eller LLM-API — supportärenden, chatbots, användargenererat innehåll, anpassade kopplingar — där ingen mänsklig granskare kommer att fånga en missad term.
Sändningsproduktnamn ändras tillräckligt ofta för att omorientering av varje leverantör och omredigering av varje uppmaning för hand har blivit en återkommande kostnad.
Använd över tio eller fler språk och behöver fallback-regler så att regionala varianter ärver ett överordnat språks termer automatiskt.

När ett ordlistnings-API kanske inte är rätt prioritet

Team som ännu inte har kommit överens om sina kanoniska produkt- och funktionsnamn - automatisering av en termbas som fortfarande diskuteras automatiserar churn.
Program med låg volym med ett eller två målspråk och en enda betrodd leverantör, där en delad ordlista i plattformens användargränssnitt och en ordlistans efterlevnadskontroll redan täpper luckan.
Rent kreativt innehåll eller transkreativt innehåll, där varumärket förblir fast men styv terminsättning fungerar mot anpassningen som betalas för.

Utvärderingschecklista: frågor att ställa innan du väljer ett översättnings-API för ordlisthantering

Visar API:et ordlistor och poster som förstklassiga resurser, eller bara som en filuppladdning?
Leta efter slutpunkter för att skapa, läsa, uppdatera, söka, arkivera och bulk-label på både ordlistan och posten, inte bara en importknapp - programmatisk synkronisering beror på att du kan adressera en enda post med dess UID.

Vilka attribut på termnivå kan ställas in via API:et?
Minst: översätt inte, skiftlägeskänslig, exakt matchning, termvariationer, del av tal och anteckningar per språk. Om ett attribut endast kan ställas in i användargränssnittet kan API:et inte hålla det synkroniserat.

Ändrar godkända villkor översättningen som API returnerar, eller flaggar den bara efteråt?
Fråga om slutpunkten för maskinöversättning utför införande av ordlistor på utdata och om LLM-leverantörer får ordlistord i prompten. En ordlista som endast kontrolleras vid granskning gör ingenting för API-översättning i realtid.

Hur hanteras böjning när en term infogas?
Bekräfta om infogningen är exakt sträng eller grammatikmedveten, och i vilka ytor var och en gäller - Smartling, till exempel, erbjuder AI-förbättrad infogning i arbetsflöden och Smartling Translate men Standardinsättning i sitt MT API.

Vilka utbytesformat stöds för massimport och export?
TBX-support är viktigt om ett terminologiteam redan har en termbas någon annanstans; CSV och XLSX är viktiga för granskare som arbetar i kalkylblad. Kontrollera om import matchar befintliga poster med UID så att återimporterna uppdateras snarare än dupliceras.

Kan stilvägledning resa med terminologin?
För LLM-översättning, fråga om lokalspecifika stilregler och exempel på översättningsminne kan injiceras tillsammans med ordlistor, så ton och terminologi verkställs i samma samtal.

Hur Smartling hanterar och verkställer ordlistor via sitt API

Smartlings Glossary API v3, dokumenterad i den offentliga OpenAPI-specifikationen på api-reference.smartling.com, behandlar ordlistor och poster som adresserbara resurser. Slutpunkter för ordlistor skapar, läser, uppdaterar, söker och maskarkiverar eller återställer ordlistor, var och en definierad med ett namn, en beskrivning, språk-ID som stöds och valfria reservspråk. Inmatningsändpunkter skapar, läser, uppdaterar, söker och maskarkiverar, återställer, tar bort eller ommärker poster. Varje post innehåller en definition, en del av talet, etikett-UID, anpassade fältvärden och ett översättningskort per lokal med termer, anteckningar, CaseSensitive, ExactMatch, Do NotTranslate, in aktiverade och upp till 50 varianter. En flagga SkipMissingTranslations låter en uppdatering beröra endast de språk som ingår i begäran, och postsvaret rapporterar alla pågående översättningsbegäranden för en term ner till jobbets UID, så ett terminologiteam kan se om en ny terms franska återgivning fortfarande finns i en lingvists kö. Ordlistor exporteras och importeras som CSV, XLSX eller TBX (TBX-Core v2 eller v3), och Smartling matchar importerade rader med befintliga poster med UID, vilket skapar en ny post endast när ID-kolumnen är tom.

Verkställighet sker i översättningssamtalet. Smartlings API för maskinöversättning — en synkron slutpunkt som översätter via valfri konfigurerad MT- eller LLM-profil utan att lagra innehåll eller skriva till översättningsminnet — tillämpar standardordlistans terminsättning från de ordlistor som valts under AI Hub > Instant MT > MT API: termer markerade DNT för källspråket överförs genom oöversatt, och termer med en godkänd målöversättning infogas som den översättningen. Endast poster märkta MT-kompatibla används, vilket förhindrar att tvetydiga poster förvirrar motorn. För LLM-profiler som använder Amazon Bedrock, GPT (OpenAI eller Azure) eller Google Gemini (Vertex AI) upptäcker Smartlings snabbverktyg med hämtningsförstärkt generering ordlistor i källtexten och skickar källtermen, dess målspråkliga term eller DNT-anteckning, upp till 10 exempel på översättningsminne och lokalspecifika stilregler för AI till prompten automatiskt - det språkliga paketet som ska användas väljs i LLM-programmet M-profil när profilen betjänar MT API. I jobbbaserade arbetsflöden använder AI-förbättrad ordlista för införande av termer, en del av Smartlings AI Hub, en stor språkmodell för att korrigera böjningen och omgivande artiklar i en infogad term, och kvalitetskontrollen för ordlistans efterlevnad flaggar eller blockerar alla segment som fortfarande saknar en godkänd term. Samma ordlista läses också av CAT Tool, Smartling Translate, Global Delivery Networks platsomfattande MT och Zendesk- och ServiceNow-integrationerna, så ordlistan som en lokaliseringshanterare upprätthåller via API:et är den som varje yta tillämpar.