Antes de 2010, aceptar un pago en línea significaba solicitar una cuenta de comerciante con un banco. Semanas de papeleo. Verificaciones de crédito. Requisitos mínimos de transacción. Después, integrabas una pasarela de pago mediante una API XML cuyo entorno de pruebas apenas se parecía a producción. Tú mismo te encargabas del cumplimiento de PCI: almacenabas números de tarjeta, administrabas claves de cifrado y pasabas auditorías de seguridad.
Hoy, un desarrollador agrega unas cuantas líneas de código a una página de checkout. Cumplimiento, detección de fraude, conversión de divisas, pagos: todo se resuelve detrás de la API. El desarrollador nunca ve la complejidad. La complejidad no desapareció. Se encapsuló.
Esto sigue pasando. Una categoría de trabajo profesional —que antes requería especialistas, proveedores y meses de coordinación— se comprime en una llamada a la API. La llamada es simple. Lo que corre detrás no lo es.
La localización profesional antes de la API#
Localizar un producto a varios idiomas implicaba contratar a un proveedor de traducción. El proveedor asignaba traductores, muchas veces poco familiarizados con el producto, el dominio o la terminología existente. Enviabas una guía terminológica. El traductor la leía, más o menos. Las traducciones volvían en 5 a 10 días hábiles. Tres términos estaban mal. Las devolvías para revisión. Otros 3 días.
Mientras tanto, alguien tenía que gestionar el glosario, rastrear qué cadenas habían cambiado desde el último lote, verificar que las traducciones al alemán usaran las comillas correctas y confirmar que la versión en portugués llevara ortografía europea, no brasileña. Toda esa coordinación ocurría entre hojas de cálculo, correos y hilos de Slack.
Para los equipos que intentaron automatizar con LLM, la traducción era rápida, pero el aseguramiento de la calidad no. Cada solicitud empezaba desde cero. Sin memoria de términos aprobados. Sin noción de la voz de marca. Sin verificación de que la salida respetara las convenciones terminológicas del dominio.
Luego, los LLM cruzaron el umbral de calidad para la traducción en producción. No porque mejoraran en idiomas, sino porque se volvió posible inyectar contexto del dominio en tiempo de inferencia y obtener una salida consistente y terminológicamente precisa. La pieza que faltaba era el flujo de contexto alrededor del modelo.
La localización profesional detrás de la API#
Un POST. Los resultados llegan por webhook a medida que se completa cada idioma.
curl -X POST https://api.lingo.dev/jobs/localization \
-H "X-API-Key: $LINGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sourceLocale": "en",
"targetLocales": ["de", "fr", "ja", "ko", "pt-BR",
"es", "it", "zh-Hans", "nl", "sv", "pl", "tr", "ar", "th"],
"data": {
"title": "Introduction to Machine Learning",
"steps": [
{ "heading": "What is ML?", "body": "Machine learning is a subset of artificial intelligence." },
{ "heading": "Supervised Learning", "body": "Training a model with labeled data." }
]
},
"callbackUrl": "https://your-app.com/webhooks/translations"
}'202 de vuelta en milisegundos. Quien llama puede seguir con lo suyo. Cada idioma se procesa de forma independiente a través del motor de localización. El alemán llega en 4 segundos. El japonés en 6. El árabe en 8. Cada resultado llega a tu webhook en cuanto está listo. Para ver el progreso en tiempo real en tu UI, conecta un WebSocket al grupo de trabajos: "3 de 16 idiomas listos" actualizándose en vivo.
El desarrollador nunca gestiona la complejidad. La complejidad no desapareció. Se encapsuló, igual que pasó con los pagos.
Qué corre detrás de la API#
Cuando comienza un trabajo de localización, la plataforma ejecuta un flujo de varios pasos según la configuración del motor. Son seis pasos, y cada uno aborda un modo de falla específico que aparece cuando te lo saltas.
Refinamiento del texto fuente
Un agente de IA preedita el texto fuente antes de que comience la traducción. Redacción ambigua, terminología inconsistente, modismos con carga cultural: todo se reescribe para facilitar la traducción. Así se elimina el problema de basura entra, basura sale que degrada cada paso posterior.
Enriquecimiento de contexto
El motor recupera el glosario, la voz de marca y las instrucciones específicas por idioma configuradas para este par de idiomas. Los términos coincidentes del glosario se inyectan en la ventana de contexto del LLM. El modelo ve la correspondencia correcta de términos antes de generar un solo token. Esto es localización aumentada por recuperación: el paso que reduce los errores terminológicos entre un 17% y un 45% en distintos proveedores.
Traducción con LLM
El motor selecciona el modelo de mayor prioridad para este par de idiomas a partir de la cadena de respaldo configurada. Si el modelo principal falla, el motor enruta automáticamente al siguiente modelo del ranking. Quien llama nunca ve la conmutación por error.
Posedición humana
Opcional. Un traductor calificado revisa y corrige el borrador generado por IA, enfocándose en lo que el modelo hizo mal, no en traducir desde cero. La plataforma se encarga de conseguir al traductor y asignarlo al dominio del contenido; los resultados llegan a través del mismo webhook. Sin gestión de proveedores, sin paso de aprobación en la UI. Tiempo de respuesta: horas, no semanas.
Enterprise
La posedición humana está disponible en beta privada en los planes enterprise. Contáctanos para habilitarla en tus motores.
Posedición con IA
Opcional. Después de la edición humana, un agente de IA aplica una pasada final de consistencia. Validación de formato, reverificación del glosario, alineación del tono con la voz de marca: se preserva la intención del traductor humano mientras se hacen cumplir estándares consistentes en todo el motor. El humano mejora la precisión. La IA impone la consistencia.
Enterprise
La posedición con IA está disponible en beta privada en los planes enterprise. Contáctanos para habilitarla.
Verificación por retraducción
Opcional. Un modelo independiente traduce la salida de vuelta al idioma fuente. El agente compara la retraducción con el texto fuente original, marca divergencias semánticas y ajusta los segmentos en los que el significado cambió durante la traducción. Esto detecta errores que una evaluación solo de ida no ve.
Enterprise
La verificación por retraducción está disponible en beta privada en los planes enterprise. Contáctanos para habilitarla.
Cada paso es configurable por motor. El refinamiento del texto fuente, la posedición humana, la posedición con IA y la retraducción pueden habilitarse o deshabilitarse de forma independiente. El enriquecimiento de contexto y la traducción con LLM siempre están activados: son el núcleo del motor.
Un equipo que localiza textos de marketing podría habilitar los seis pasos. Un equipo que localiza documentación interna podría ejecutar solo el enriquecimiento de contexto y la traducción con LLM. La llamada a la API es la misma en ambos casos. El flujo se adapta.
Entrega#
Los resultados llegan por el canal que configuraste, sin necesidad de polling.
Webhooks: cada idioma se entrega en cuanto se completa. Una traducción al alemán que termina en 4 segundos llega de inmediato, sin esperar a que el japonés termine en 6. Cada webhook incluye una firma criptográfica que sigue la especificación de Standard Webhooks. Las entregas fallidas se reintentan con backoff exponencial hasta 5 veces.
WebSocket: conéctate a un grupo de trabajos para ver el progreso en tiempo real. Cada evento incluye una instantánea completa del estado: total de trabajos, trabajos completados, trabajos fallidos, estado por idioma. Tu frontend nunca mantiene estado local: el servidor envía el estado actual en cada evento.
Aislamiento de fallas: si el japonés falla pero el alemán se completa correctamente, la traducción al alemán se entrega normalmente. El trabajo fallido aparece con un mensaje de error. El estado del grupo pasa a ser partial. Reintenta enviando una nueva solicitud solo con los idiomas fallidos.
Qué significa esto#
Cumplimiento, gobernanza terminológica, adaptación al dominio, revisión humana, puntuación de calidad: todo se resuelve detrás de la API. El desarrollador envía contenido e idiomas de destino. El gerente de localización configura el motor. La plataforma ejecuta el flujo de trabajo.
La coordinación que antes requería un gerente de proyecto, una relación con un proveedor y una hoja de cálculo compartida ahora sucede dentro de un flujo de trabajo en segundo plano y duradero, con entrega por webhook, aislamiento de fallas y transmisión de progreso en tiempo real.
Si tu necesidad de localización es traducir un documento una sola vez y sin requisitos de consistencia entre lanzamientos, la API está sobredimensionada para lo que necesitas. El valor del motor se acumula con el tiempo: los términos del glosario se acumulan, la voz de marca se afina y las puntuaciones de calidad tienden al alza. Lingo.dev está diseñado específicamente para productos que lanzan de forma continua, donde el mismo contenido cambia en cada sprint y la consistencia entre idiomas no es negociable.
Lee la referencia completa de la API o agenda una demo para ver el flujo en acción.
