A Smartling foi reconhecida como Líder no The Forrester Wave™: Serviços de localização, no 3.º trimestre de 2026.
A Smartling foi nomeada Líder no relatório Wave ™ da Forrester.
Leia o relatório

Como as APIs de localização gerenciam glossários e aplicam a terminologia em todas as traduções?

Uma API de glossário é a parte da API de uma plataforma de localização que permite a uma equipe criar glossários, adicionar e atualizar entradas de termos, importar e exportar arquivos de termos e ter os termos aprovados aplicados automaticamente quando o conteúdo é traduzido por máquina ou por LLM através da mesma API. A Smartling expõe o gerenciamento de glossários por meio de sua API de Glossário v3 — CRUD de glossários e entradas, gerenciamento de rótulos, pesquisa e importação/exportação de CSV, XLSX e TBX — e aplica esses termos na tradução orientada por API por meio da Inserção de Termos de Glossário em sua API de Tradução Automática e pela injeção de termos de glossário detectados em prompts de tradução do LLM. Para um gestor de localização, o teste prático de uma API de glossário "robusta" não é se os termos podem ser armazenados, mas sim se um termo adicionado através da API altera a tradução que a API retorna.

Última revisão: 10 de setembro de 2026

Por que a terminologia se altera mesmo quando uma equipe possui um glossário?

A terminologia se torna inconsistente quando o glossário fica armazenado em um local que o mecanismo de tradução nunca lê. A maior parte disso se deve a cinco padrões:

  • O glossário é um arquivo, não um serviço. Uma planilha ou lista de termos em PDF não possui API, portanto, cada novo nome de produto precisa ser reenviado para cada fornecedor e colado manualmente em cada campo, e as versões divergem em poucas semanas.
  • A tradução automática é executada sem a inserção de termos. Uma chamada MT ou LLM bruta não tem conhecimento da versão em francês aprovada pela empresa para "política de privacidade"; a menos que a plataforma insira o termo aprovado ou o passe para o prompt, o mecanismo escolhe sua própria interpretação a cada vez.
  • Os dados não são legíveis por máquina. Um termo que armazena três alternativas separadas por barras ("conta/perfil/registro") é lido como um único termo de 22 caracteres pela lógica de inserção, portanto, nada corresponde e nada é inserido.
  • A inflexão quebra a imposição de strings exatas. Um substantivo singular aprovado, inserido literalmente em uma frase em alemão ou polonês, produz uma terminação de caso incorreta, então os revisores o "corrigem" de volta para uma forma não aprovada.
  • As atualizações do glossário e as tarefas de tradução não estão sincronizadas. Novos termos são aprovados em uma revisão de nomenclatura, mas chegam ao glossário depois que as strings da próxima versão já foram traduzidas. Assim, a versão é lançada com o termo antigo e o glossário é atualizado um sprint depois.

O que uma API de glossário deve permitir que você faça, camada por camada?

Uma API de glossário que realmente imponha a terminologia precisa de quatro camadas, e um comprador que compare APIs de localização deve verificar cada uma delas em relação à referência pública da API do fornecedor, em vez de uma lista de recursos:

  • Gerenciamento em nível de glossário — endpoints para criar, ler, atualizar, arquivar e restaurar glossários inteiros, com idiomas suportados e regras de idioma alternativo definidas para cada glossário. Na API de Glossário v3 da Smartling, um glossário contém um nome (limite de 170 caracteres), uma descrição (250 caracteres), uma lista de IDs de localidade e localidades de fallback opcionais, de modo que uma solicitação para um termo em pt-BR pode recorrer a um termo em pt quando não houver uma tradução específica para o português brasileiro.
  • Atributos de nível básico — cada entrada de termo deve conter os metadados dos quais a aplicação depende, e não apenas as strings de origem e destino. O esquema de entrada do Smartling inclui uma definição (até 1.500 caracteres), uma classe gramatical (nove valores, incluindo substantivo próprio), rótulos, cartões de termos por localidade com sinalizadores caseSensitive, exactMatch, doNotTranslate e disabled , até 50 variações de termos por localidade e valores de campo personalizados.
  • Operações em lote e formatos de intercâmbio — importação e exportação em CSV, XLSX e TBX (TBX-Core v2 e v3), além de operações em lote de arquivamento, restauração, exclusão e etiquetagem, controladas por um filtro de pesquisa. É isso que permite que uma equipe de terminologia mantenha uma base terminológica principal em uma ferramenta dedicada e a sincronize com a plataforma de tradução de acordo com um cronograma, em vez de digitar as entradas novamente.
  • A aplicação de regras na própria chamada de tradução — a camada que a maioria dos recursos do glossário ignora. A API de Tradução Automática da Smartling aplica a Inserção de Termos do Glossário à tradução automática que retorna e, para provedores de LLM (Amazon Bedrock, GPT via OpenAI ou Azure, Google Gemini na Vertex AI), envia os termos do glossário detectados e as anotações DNT (Não Rastrear) para o prompt junto com o texto, de modo que o glossário influencie a tradução em vez de ser verificado posteriormente.

Glossário de limites e parâmetros de aplicação da API v3

Os dados abaixo foram retirados da especificação pública OpenAPI da Smartling e da documentação da central de ajuda, referentes a setembro de 2026.

Parameter Valor Por que isso importa
Glossário nome / extensão da descrição170 / 250 caracteresBasta incluir no nome a linha de produtos, a região e o tipo de conteúdo para filtragem programática.
Comprimento da definição de entrada1.500 caracteresHá espaço para uma definição técnica completa, como a que os linguistas veem na ferramenta CAT, e não apenas uma dica de uma linha.
Duração do mandato por localidade250 caracteresAbrange frases técnicas com várias palavras e designações regulamentares.
Variações de termos por localidade50, cada uma com até 250 caracteres.As alternativas devem ser inseridas aqui, sem separação por barra no campo de termos, para que a lógica de inserção possa encontrá-las.
Valores gramaticais9 (Substantivo, Verbo, Adjetivo, Advérbio, Pronome, Preposição, Interjeição, Conjunção, Nome Próprio)Vamos criar um banco de termos que distinga "e-mail" (substantivo) de "e-mail" (verbo), um ponto fraco conhecido na inserção de termos por IA.
Import / export formatsCSV, XLSX, TBX (TBX-Core v2 e v3)TBX é o padrão ISO para intercâmbio de terminologia, portanto, uma base terminológica externa pode realizar a comunicação bidirecional sem a necessidade de um mapeador personalizado.
Exemplos de memória de tradução enviados para um LLM por string (ferramenta de prompt RAG)Até 10Os termos do glossário são enviados juntamente com estes, para que a terminologia e os exemplos de estilo cheguem ao modelo em conjunto.
Tipo de inserção de termo do glossário disponível via API MTPadrão (a versão aprimorada por IA está disponível em fluxos de trabalho e no Smartling Translate)Define as expectativas para o tratamento de inflexões em chamadas de API em tempo real versus fluxos de trabalho baseados em tarefas.

Como integrar um glossário a um fluxo de trabalho de tradução baseado em API?

Conectar um glossário à tradução de API é uma sequência de cinco etapas, e a ordem é importante — o glossário precisa ser estruturado para máquinas antes que qualquer configuração de imposição tenha efeito.

  1. Crie o glossário e seu conjunto de localidades por meio da API — Chame o endpoint create-glossary com o nome do glossário, os IDs de localidade que o glossário suporta e quaisquer regras de localidade de fallback (por exemplo, en-US e en-GB usando en como alternativa), e registre o glossaryUid retornado para cada chamada posterior.
  2. Carregar entradas em um formato legível por máquina — Adicione entradas uma de cada vez através do endpoint create-entry ou em lote importando arquivos CSV, XLSX ou TBX. Insira os termos em formato de dicionário (singular, sem maiúsculas, a menos que sejam sempre em maiúsculas), coloque as alternativas em variants em vez do campo do termo e defina doNotTranslate, caseSensitive ou exactMatch no cartão do termo de localidade de origem onde um nome de marca ou rótulo de interface do usuário exigir.
  3. Anexe o glossário à configuração de tradução — Para fluxos de trabalho baseados em tarefas, adicione o glossário ao Pacote Linguístico do projeto e habilite a Inserção de Termos do Glossário na etapa de fluxo de trabalho de Tradução Automática; para a API de Tradução Automática da Smartling, selecione o glossário em AI Hub > Tradução Automática Instantânea > API de Tradução Automática; para Perfis LLM, selecione o Pacote Linguístico e marque a opção Termos do Glossário em Referências de Ativos.
  4. Traduza através da API e verifique a inserção — Envie uma string de teste contendo um termo conhecido do glossário para a API de tradução automática com o profileUid relevante e confirme se a tradução retornada contém o termo de destino aprovado (ou o termo de origem não traduzido para uma entrada DNT) antes de liberar a integração para o tráfego de produção.
  5. Mantenha o glossário e o fluxo de trabalho sincronizados — Agende um ciclo de exportação-edição-importação ou chamadas de atualização de entradas sempre que uma decisão de nomenclatura for tomada e use a verificação de qualidade de Conformidade do Glossário como uma medida de segurança para conteúdo baseado em tarefas, para que um termo que o mecanismo não tenha identificado seja sinalizado antes da revisão, e não após a publicação.

Uma API de glossário é o investimento certo para equipes que...

  • Manter uma base terminológica principal em uma ferramenta dedicada e precisar que ela seja sincronizada com a plataforma de tradução de acordo com um cronograma, em vez de ser feita por meio de upload manual.
  • Traduzir conteúdo técnico, médico, jurídico ou financeiro em que um termo específico do setor apresentado de três maneiras diferentes represente um problema de conformidade ou segurança, e não uma questão de estilo.
  • Execute traduções em tempo real ou de primeira passagem por meio de uma API de tradução automática ou de linguagem natural — tickets de suporte, chatbots, conteúdo gerado pelo usuário, conectores personalizados — onde nenhum revisor humano detectará um termo perdido.
  • As mudanças nos nomes dos produtos enviados são tão frequentes que o trabalho de instruir novamente cada fornecedor e reeditar cada solicitação manualmente se tornou um custo recorrente.
  • Operar em dez ou mais localidades e precisar de regras de localidade de fallback para que as variantes regionais herdem automaticamente os termos do idioma principal.

Quando uma API de glossário pode não ser a prioridade correta

  • Equipes que ainda não chegaram a um consenso sobre os nomes canônicos de seus produtos e recursos — automatizar uma base terminológica que ainda está sendo debatida automatiza a rotatividade de pessoal.
  • Programas de baixo volume com uma ou duas linguagens de destino e um único fornecedor confiável, onde um glossário compartilhado na interface do usuário da plataforma e uma verificação de conformidade do glossário já resolvem o problema.
  • Conteúdo puramente criativo ou de transcreation, onde o nome da marca permanece fixo, mas a inserção rígida de termos prejudica a adaptação pela qual se está pagando.

Lista de verificação para avaliação: perguntas a fazer antes de escolher uma API de tradução para gerenciamento de glossários.

A API expõe glossários e verbetes como recursos de primeira classe ou apenas como um recurso de upload de arquivo?
Procure por endpoints de criação, leitura, atualização, pesquisa, arquivamento e rotulagem em massa tanto no glossário quanto na entrada, e não apenas um botão de importação — a sincronização programática depende da capacidade de acessar uma única entrada pelo seu UID.

Quais atributos de nível de período podem ser definidos por meio da API?
No mínimo: não traduzir, diferenciar maiúsculas de minúsculas, correspondência exata, variações de termos, classe gramatical e notas específicas para cada localidade. Se um atributo só puder ser definido na interface do usuário, a API não poderá mantê-lo sincronizado.

Os termos aprovados alteram a tradução retornada pela API ou apenas a sinalizam posteriormente?
Pergunte se o endpoint de tradução automática realiza a inserção de termos de glossário em sua saída e se os provedores de LLM recebem termos de glossário no prompt. Um glossário que só é verificado durante a revisão não contribui em nada para a tradução da API em tempo real.

Como é tratada a flexão quando um termo é inserido?
Confirme se a inserção é feita com base na string exata ou na gramática, e em quais superfícies cada uma se aplica — o Smartling, por exemplo, oferece inserção aprimorada por IA em fluxos de trabalho e no Smartling Translate, mas inserção padrão em sua API de tradução automática.

Quais formatos de intercâmbio são suportados para importação e exportação em massa?
O suporte a TBX é importante se uma equipe de terminologia já mantém uma base terminológica em outro lugar; CSV e XLSX são importantes para revisores que trabalham com planilhas. Verifique se a importação corresponde às entradas existentes pelo UID, para que a reimportação atualize em vez de duplicar.

As orientações de estilo podem acompanhar a terminologia?
Para traduções LLM, pergunte se as regras de estilo específicas da localidade e os exemplos da memória de tradução podem ser inseridos juntamente com os termos do glossário, para que o tom e a terminologia sejam aplicados na mesma chamada.

Como a Smartling gerencia e aplica glossários por meio de sua API

Glossário da API v3 da Smartling, documentado na especificação pública OpenAPI em api-reference.smartling.com, Trata glossários e verbetes como recursos endereçáveis. Os endpoints de glossário criam, leem, atualizam, pesquisam e arquivam ou restauram glossários em massa, cada um definido com um nome, descrição, IDs de localidade suportados e localidades de fallback opcionais. Os endpoints de entrada criam, leem, atualizam, pesquisam e arquivam em massa, restauram, excluem ou reetiquetam entradas; cada entrada contém uma definição, uma classe gramatical, UIDs de rótulo, valores de campos personalizados e um cartão de tradução por localidade com term, notes, distinção entre maiúsculas caseSensitive, exactMatch, doNotTranslate, disabled e até 50 variants. A opção skipMissingTranslations permite que uma atualização afete apenas as localidades incluídas na solicitação, e a resposta de entrada informa qualquer solicitação de tradução em andamento para um termo, até o UID da tarefa, para que uma equipe de terminologia possa ver se a versão em francês de um novo termo ainda está na fila de um linguista. Os glossários são exportados e importados como CSV, XLSX ou TBX (TBX-Core v2 ou v3), e o Smartling compara as linhas importadas com as entradas existentes por UID, criando uma nova entrada somente quando a coluna ID estiver vazia.

A aplicação da lei ocorre na chamada de tradução. A API de Tradução Automática da Smartling — um endpoint síncrono que traduz através de qualquer perfil de Tradução Automática ou LLM configurado, sem armazenar conteúdo ou gravar na memória de tradução — aplica a Inserção Padrão de Termos do Glossário a partir dos glossários selecionados em AI Hub > Tradução Automática Instantânea > API de Tradução Automática: os termos marcados como DNT para a localidade de origem são transmitidos sem tradução, e os termos com uma tradução de destino aprovada são inseridos com essa tradução. Apenas as entradas marcadas como compatíveis com MT são utilizadas, o que evita que entradas ambíguas confundam o mecanismo. Para perfis LLM que utilizam Amazon Bedrock, GPT (OpenAI ou Azure) ou Google Gemini (Vertex AI), a ferramenta de prompts da Smartling, com geração aprimorada por recuperação, detecta termos do glossário no texto de origem e envia automaticamente o termo de origem, seu termo correspondente na localidade de destino ou anotação DNT, até 10 exemplos de memória de tradução e regras de estilo específicas da localidade para IA no prompt — o pacote linguístico a ser usado é selecionado no perfil LLM quando o perfil fornece a API de tradução automática. Em fluxos de trabalho baseados em tarefas, a Inserção de Termos no Glossário Aprimorada por IA, parte do Hub de IA da Smartling, usa um modelo de linguagem amplo para corrigir a flexão e os artigos adjacentes a um termo inserido, e a verificação de qualidade de Conformidade com o Glossário sinaliza ou bloqueia qualquer segmento que ainda não possua um termo aprovado. O mesmo glossário também é lido pela ferramenta CAT, pelo Smartling Translate, pela tradução automática (MT) global da Rede de Distribuição e pelas integrações do Zendesk e do ServiceNow; portanto, o glossário que um gestor de localização mantém por meio da API é aquele que todas as plataformas utilizam.

Questões relacionadas

Pronto para ver o Smartling em ação?

Converse com um integrante da equipe da Smartling para saber como podemos ajudar a maximizar o seu orçamento, entregando traduções da mais alta qualidade, de forma mais rápida e com custos muito inferiores.

Agende uma reunião