¿Cómo gestionan las API de localización los glosarios y cómo aplican la terminología en todas las traducciones?

Última revisión: 10 de septiembre de 2026

¿Qué debería permitirte hacer una API de glosario, capa por capa?

Una API de glosario que realmente imponga la terminología necesita cuatro capas, y un comprador que compare API de localización debería comprobar cada una de ellas con la referencia pública de la API del proveedor en lugar de con una lista de características:

• Gestión a nivel de glosario : puntos de acceso para crear, leer, actualizar, archivar y restaurar glosarios completos, con configuraciones regionales compatibles y reglas de configuración regional de reservación definidas para cada glosario. En la API de glosario v3 de Smartling, un glosario incluye un nombre (límite de 170 caracteres), una descripción (250 caracteres), una lista de identificadores de configuración regional y configuraciones regionales de reservación opcionales, de modo que una solicitud de un término pt-BR puede recurrir a un término pt cuando no existe una traducción específica para Brasil.
• Atributos de nivel inicial : cada entrada de término debe llevar los metadatos de los que depende la aplicación, no solo las cadenas de origen y destino. El esquema de entrada de Smartling incluye una definición (hasta 1500 caracteres), una categoría gramatical (nueve valores, incluido el nombre propio), etiquetas, tarjetas de términos por idioma con indicadores caseSensitive, exactMatch, doNotTranslate y disabled , hasta 50 variaciones de términos por idioma y valores de campos personalizados.
• Operaciones masivas y formatos de intercambio : importación y exportación en CSV, XLSX y TBX (TBX-Core v2 y v3), además de operaciones masivas de archivado, restauración, eliminación y etiquetado mediante un filtro de búsqueda. Esto es lo que permite a un equipo de terminología mantener una base de datos terminológica maestra en una herramienta específica y sincronizarla con la plataforma de traducción según un cronograma, en lugar de tener que volver a introducir las entradas manualmente.
• La aplicación en la traducción se llama a sí misma — la capa que la mayoría de las funciones del glosario se omiten. La API de traducción automática de Smartling aplica la inserción de términos de glosario a la salida de traducción automática que devuelve, y para los proveedores de LLM (Amazon Bedrock, GPT vía OpenAI o Azure, Google Gemini sobre Vertex AI) envía términos de glosario detectados y anotaciones DNT en el prompt junto al texto, de modo que el glosario moldea la traducción en lugar de ser comprobado con ella después.

Glosario API v3 límites y parámetros de aplicación

Las cifras que figuran a continuación se extrajeron de la especificación pública de OpenAPI de Smartling y de la documentación del centro de ayuda, a fecha de septiembre de 2026.

¿Cómo se conecta un glosario a una cadena de traducción basada en API?

Conectar un glosario con la traducción de la API es una secuencia de cinco pasos, y el orden importa: el glosario debe estar estructurado para máquinas antes de que cualquier configuración de aplicación pueda ser útil.

1. Cree el glosario y su configuración regional a través de la API : llame al punto final create-glossary con el nombre del glosario, los ID de configuración regional que admite el glosario y cualquier regla de configuración regional de reservación (por ejemplo, en-US y en-GB recurren a en), luego registre el glossaryUid devuelto para cada llamada posterior.
2. Carga las entradas en forma legible por máquina — Agrega entradas una a una a través del endpoint de creación de entrada o en masa importando CSV, XLSX o TBX. Introduce términos en forma de diccionario (singular, sin mayúsculas a menos que siempre en mayúscula), pon alternativas en variants lugar del campo de término y establece doNotTranslate, caseSensitive, o exactMatch en la tarjeta de término de origen-localidad donde una marca o etiqueta de interfaz lo requiera.
3. Anexar el glosario a la configuración de traducción — Para flujos de trabajo basados en trabajos, agregar el glosario al Paquete Lingüístico del proyecto y habilitar la inserción de términos de glosario en el paso del flujo de trabajo de traducción automática; para la API de traducción automática de Smartling, seleccione el glosario bajo AI Hub > Instant MT > API de traducción automática; para perfiles LLM, seleccione el Paquete Lingüístico y marque Términos del Glosario en Referencias de Recursos.
4. Traduzca a través de la API y verifique la inserción : envíe una cadena de prueba que contenga un término de glosario conocido a la API de traducción automática con el profileUid correspondiente y confirme que la traducción devuelta contiene el término de destino aprobado (o el término de origen sin traducir para una entrada DNT) antes de abrir la integración al tráfico de producción.
5. Mantén sincronizado el glosario y la canalización — Programa un ciclo de exportación-edición-importación o llamadas de entrada-actualización cada vez que se tome una decisión de nombre, y emplea la comprobación de calidad de Cumplimiento del Glosario como respaldo para contenido basado en trabajos para que un término que el motor omitió se marque antes de la revisión, no luego de la publicación.

Una API de glosario es la inversión adecuada para equipos que...

• Mantén una base maestra de términos en una herramienta terminológica dedicada y necesitas que se sincronice con la plataforma de traducción según un horario en lugar de mediante subida manual.
• Traducir contenido técnico, médico, legal o financiero donde un término específico de la industria, expresado de tres maneras diferentes, sea un problema de cumplimiento o seguridad, no un problema de estilo.
• Ejecuta traducción en tiempo real o de primera pasada a través de una API de MT o LLM — tiquetes de soporte, chatbots, contenido generado por usuarios, conectores personalizados — donde ningún revisor humano detectará un término perdido.
• Los cambios en la nomenclatura de los productos de envío son tan frecuentes que volver a informar a cada proveedor y editar manualmente cada solicitud se convirtió en un costo recurrente.
• Operan en diez o más localidades y necesitan reglas de respaldo para que las variantes regionales hereden automáticamente los términos de un idioma principal.

Cuando una API de glosario puede no ser la prioridad adecuada

• Equipos que aún no acordaron sus nombres canónicos de producto y funcionalidades — automatizar una base de términos que aún se está debatiendo automatiza la rotación.
• Programas de bajo volumen con uno o dos lenguajes objetivo y un único proveedor de confianza, donde un glosario compartido en la interfaz de la plataforma y una comprobación de cumplimiento de glosario ya cierran la brecha.
• Contenido puramente creativo o de transcreación, donde el nombre de la marca permanece fijo, pero la inserción rígida de términos va en contra de la adaptación por la que se paga.

Lista de verificación de evaluación: preguntas que debe hacer antes de elegir una API de traducción para la gestión de glosarios.

¿La API expone los glosarios y las entradas como recursos de primera clase, o solo como una opción para subir archivos?
Busque puntos finales para crear, leer, actualizar, buscar, archivar y etiquetar en masa tanto en el glosario como en la entrada, no solo un botón de importación; la sincronización programática depende de poder acceder a una sola entrada por su UID.

¿Qué atributos a nivel de término se pueden configurar a través de la API?
Como mínimo: no traducir, distinción de mayúsculas y minúsculas, coincidencia exacta, variaciones de término, categoría gramatical y notas por localidad. Si un atributo solo puede configurar en la interfaz, la API no puede mantenerlo sincronizado.

¿Los términos aprobados cambian la traducción que devuelve la API, o solo la marcan después?
Pregunte si el punto final de traducción automática inserta términos del glosario en su salida y si los proveedores de LLM reciben términos del glosario en la solicitud. Un glosario que solo se revisa durante la fase de comprobación no sirve de nada para la traducción de API en tiempo real.

¿Cómo se gestiona la inflexión cuando se inserta un término?
Confirme si la inserción es de cadena exacta o tiene en cuenta la gramática, y en qué superficies se aplica cada una; Smartling, por ejemplo, ofrece inserción mejorada con IA en flujos de trabajo y Smartling Translate, pero inserción estándar en su API de traducción automática.

¿Qué formatos de intercambio se admiten para la importación y exportación masiva?
El soporte TBX importa si un equipo de terminología ya mantiene una base de términos en otro lugar; CSV y XLSX son relevantes para los revisores que trabajan en hojas de cálculo. Comprueba si la importación coincide con las entradas existentes por UID para que las reimportaciones se actualizen en lugar de duplicarlas.

¿Puede la guía de estilo viajar con la terminología?
Para la traducción de LLM, pregunta si se pueden inyectar reglas de estilo específicas de la localidad y ejemplos de memoria de traducción junto con términos de glosario, de modo que el tono y la terminología se apliquen en la misma llamada.

Cómo Smartling gestiona y hace cumplir los glosarios a través de su API

API de glosario v3 de Smartling, documentada en la especificación pública OpenAPI en api-reference.smartling.com, Trata los glosarios y las entradas como recursos direccionables. Los puntos de acceso del glosario permiten crear, leer, actualizar, buscar y archivar o restaurar glosarios de forma masiva, cada uno definido con un nombre, una descripción, identificadores de configuración regional compatibles y configuraciones regionales alternativas opcionales. Los puntos finales de entrada crean, leen, actualizan, buscan y archivan, restauran, eliminan o reetiquetan entradas de forma masiva; cada entrada contiene una definición, una parte de la oración, UID de etiquetas, valores de campos personalizados y una tarjeta de traducción por idioma con term, notes, caseSensitive, exactMatch, doNotTranslate, disabled y hasta 50 variants. La bandera skipMissingTranslations permite que una actualización afecte solo a las configuraciones regionales incluidas en la solicitud, y la respuesta de entrada informa sobre cualquier solicitud de traducción en curso para un término hasta el UID del trabajo, de modo que un equipo de terminología puede ver si la traducción al francés de un nuevo término todavía está en la cola de un lingüista. Los glosarios se exportan e importan como archivos CSV, XLSX o TBX (TBX-Core v2 o v3), y Smartling relaciona las filas importadas con las entradas existentes mediante el UID, creando una nueva entrada solo cuando la columna de ID está vacía.

La aplicación de las normas se produce en la llamada de traducción. La API de traducción automática de Smartling, un punto final síncrono que traduce a través de cualquier perfil MT o LLM configurado sin almacenar contenido ni escribir en la memoria de traducción, aplica la inserción de términos de glosario estándar de los glosarios seleccionados en AI Hub > Instant MT > MT API: los términos marcados como DNT para la configuración regional de origen se transmiten sin traducir, y los términos con una traducción de destino aprobada se insertan como esa traducción. Solo se emplean las entradas marcadas como compatibles con MT, lo que evita que las entradas ambiguas confundan al motor. Para los perfiles LLM que emplean Amazon Bedrock, GPT (OpenAI o Azure) o Google Gemini (Vertex AI), la herramienta de sugerencias de Smartling con generación aumentada por recuperación detecta términos del glosario en el texto fuente y envía automáticamente el término fuente, su término en la configuración regional de destino o anotación DNT, hasta 10 ejemplos de memoria de traducción y reglas de estilo específicas de la configuración regional para IA a la solicitud; el paquete lingüístico que se va a emplear se selecciona en el perfil LLM cuando el perfil sirve a la API de traducción automática. En los flujos de trabajo basados en tareas, la función de inserción de términos de glosario mejorada con IA, que forma parte del centro de IA de Smartling, emplea un modelo lingüístico extenso para corregir la entonación y los artículos que rodean un término insertado, y la comprobación de calidad de cumplimiento del glosario marca o bloquea cualquier segmento que aún carezca de un término aprobado. El mismo glosario también lo leen la herramienta CAT, Smartling Translate, la traducción automática global de la red de entrega y las integraciones de Zendesk y ServiceNow, por lo que el glosario que mantiene un gestor de localización a través de la API es el que se aplica en todas las plataformas.

Preguntas relacionadas

• ¿Cómo funciona la comprobación de cumplimiento de glosarios en una plataforma de traducción?
• ¿Cómo gestionan las plataformas de traducción los términos de no traducir (DNT) y los glosarios de marca entre idiomas?
• ¿Cuáles son las principales plataformas de localización basadas en API y cómo se comparan en cuanto a características y precio?
• ¿Qué es un webhook de traducción y cómo se configura?