Traducir con glosario
Un traductor genérico puede escribir el nombre de un mismo producto de tres formas distintas dentro del mismo documento, porque no tiene idea de que esa palabra está prohibida de tocar. Este endpoint recibe un glosario junto con el texto y fija términos específicos a las traducciones que usted define, para que el nombre de su marca, su término legal o su función de producto queden exactamente como los escribió.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
La palabra que cambia cuando no debería
Una empresa de software llama a su función principal 'Workspace' en inglés y quiere que se mantenga como 'Workspace' -sin traducir- en todos los idiomas, porque dentro de la interfaz del producto funciona como nombre propio. Un bufete necesita que 'sociedad anónima' siempre se traduzca a una frase fija en inglés, no al sinónimo que un modelo elija ese día. Un fabricante de dispositivos médicos tiene una lista de nombres de componentes que deben coincidir palabra por palabra con lo que presentó ante el regulador. Una traducción genérica no tiene forma de saber nada de esto a menos que se le indique, y decírselo una sola vez por documento no es confiable: hay que imponerlo cada vez.
Cómo se aplica realmente el glosario
Envíe POST a /translate/glossary con el texto de origen, el idioma destino y un glosario de pares término de origen-término de destino; recibirá un task_id de inmediato y el trabajo corre de forma asíncrona igual que el resto de los endpoints de traducción. Durante la traducción, cada aparición de un término del glosario se fuerza a la traducción que usted definió en lugar de dejarla al criterio del modelo, mientras que todo lo demás se traduce con normalidad, así que la oración sigue leyéndose natural, solo que nunca se desvía en los términos que importan.
Por qué existe el glosario como concepto de traducción
La terminología controlada es anterior a la traducción automática por décadas: los redactores técnicos y los equipos de localización han mantenido bases terminológicas para software empresarial y documentación farmacéutica desde mucho antes de que la traducción automática fuera confiable, precisamente porque la consistencia en vocabulario especializado no puede dejarse al azar ni a la preferencia personal de un traductor. Un glosario es la misma idea aplicada a una llamada de API: en lugar de esperar que el resultado coincida por casualidad con su guía de estilo, usted entrega el mapeo y la traducción queda obligada a seguirlo, término por término, documento tras documento.
Cómo encaja en un flujo real de terminología
Los equipos que ya mantienen una guía de estilo o una base terminológica tienen la materia prima de un glosario guardada en alguna hoja de cálculo; alimentar esa lista a /translate/glossary convierte un documento de referencia estático en una restricción activa sobre cada traducción que pasa por el flujo. Como el precio es una tarifa base pequeña más una tarifa por cada 1000 palabras, aplicar el mismo glosario a un conjunto creciente de documentos -notas de versión, contratos, descripciones de producto- sigue siendo predecible incluso cuando el glosario mismo crece para cubrir más términos con el tiempo.
Qué puede hacer con ella
Nombres de producto y de funciones
Una empresa de software impone que el nombre de una función propia permanezca sin traducir y consistente en cada versión localizada de su centro de ayuda.
Consistencia de términos legales
Un bufete impone una traducción fija al inglés para términos legales locales recurrentes, para que cada contrato traducido use exactamente la misma redacción.
Nombres de componentes regulados
Un fabricante de dispositivos médicos fija los nombres de componentes traducidos para que coincidan exactamente con lo presentado ante el regulador, evitando discrepancias que retrasen la aprobación.
Voz de marca en distintos mercados
Una marca de retail mantiene su eslogan y los nombres de categorías idénticos en cada mercado al ingresarlos como entradas fijas del glosario en lugar de dejarlos a la traducción.
Preguntas frecuentes
¿Cómo funciona la traducción con glosario en la API?
Envíe su texto, el idioma destino y una lista de pares término de origen-término de destino por POST a /translate/glossary; el task_id devuelto le permite recibir la traducción terminada por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API de traducción con glosario?
No, no hay plan gratuito ni prueba; cuesta $0.003 por solicitud más $0.0135 por cada 1000 palabras, y un trabajo fallido nunca se cobra.
¿El glosario reemplaza por completo al modelo en esos términos?
Sí, cualquier término del glosario que aparezca en el texto de origen se fuerza a la traducción que usted definió, en lugar de dejarla a criterio del modelo.
¿Cuántos términos puedo incluir en el glosario?
Puede enviar tantos pares de origen-destino como necesite su terminología; un glosario más grande no cambia cómo se llama al endpoint, solo el mapeo que impone.
¿Puedo usar un glosario distinto por par de idiomas?
Sí, como el glosario se envía con cada solicitud, puede asociar una base terminológica diferente a cada idioma destino según lo necesite.
¿Es distinto de traducción con formalidad o que conserva el tono?
Sí, la traducción con glosario fija términos específicos a un resultado exacto; formalidad y conservación de tono controlan el registro y la voz del resto del texto.
¿Puedo ejecutar traducción con glosario en muchos documentos a la vez?
Sí, envíe una tarea asíncrona por documento con el mismo glosario adjunto, y reciba cada resultado por webhook a medida que se completa.
¿Se guarda mi glosario o mi texto después?
No, el texto enviado y los datos del glosario se eliminan después del período de retención y nunca se usan para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/translate/glossary \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/glossary", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/glossary",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/glossary", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/glossary", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"text": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.glossary",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |