El CLI de Lingo.dev conecta tu código con un motor de localización mediante un solo campo de configuración. Cada llamada a lingo.dev run pasa por tu motor y aplica automáticamente tu voz de marca, glosario, instrucciones y configuración de modelo. Sin cambios de código ni dependencias nuevas.
Qué cambia#
| Antes | Después | |
|---|---|---|
| Flujo de traducción | Flujo predeterminado de Lingo.dev | Tu motor de localización |
| Voz de marca | Ninguna | Se aplica por idioma de destino |
| Glosario | Ninguno | Coincidencia semántica en cada solicitud |
| Instrucciones | Ninguna | Se incluyen por idioma de destino |
| Selección de modelo | Predeterminado de Lingo.dev | Tu configuración de modelo con fallbacks |
| Evaluación de calidad | Ninguna | Tus evaluadores de IA configurados se ejecutan automáticamente |
Configuración#
Agrega engineId a i18n.json (opcional)
Para usar un motor específico, agrega el campo engineId a tu configuración de i18n.json. Encuentra el ID de tu motor en el dashboard: empieza con eng_ (por ejemplo, eng_SxjMwMsfOIsvV1wh).
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Todo lo demás en tu configuración sigue igual: idioma de origen, destinos, buckets. Si omites engineId, el CLI usa el motor predeterminado de tu organización.
Configura tu API key
El CLI se autentica con tu API key de Lingo.dev. Defínela como variable de entorno:
export LINGO_API_KEY="your-api-key"O guárdala en ~/.lingodotdevrc:
[auth.vnext]
apiKey = your-api-keyGenera una API key desde la página API Keys en el dashboard.
Ejecuta las traducciones
lingo.dev runEl CLI envía solicitudes de traducción a tu motor y escribe los resultados en tus archivos de idioma, aplicando automáticamente tu voz de marca, glosario, instrucciones y configuración de modelo.
Referencia de configuración#
i18n.json#
| Campo | Descripción |
|---|---|
engineId | Opcional. El ID de tu motor (eng_...). Si se omite, se usa el motor predeterminado de tu organización. |
Todos los demás campos de i18n.json (version, locale, buckets) funcionan igual que en la configuración estándar del CLI.
Variables de entorno#
| Variable | Obligatoria | Predeterminado | Descripción |
|---|---|---|---|
LINGO_API_KEY | Sí | - | Tu API key de Lingo.dev |
LINGO_API_URL | No | https://api.lingo.dev | URL base personalizada de la API (para entornos self-hosted o de staging) |
Qué esperar#
Cada traducción que genera el CLI pasa por todo el flujo de tu motor:
- Voz de marca define el tono y la formalidad según el idioma
- Elementos del glosario garantizan una terminología precisa mediante coincidencia semántica
- Instrucciones aplican reglas lingüísticas específicas de cada idioma
- Configuraciones de modelo seleccionan el LLM correcto con fallbacks automáticos
- Evaluadores de IA evalúan la calidad automáticamente después de cada solicitud
Las traducciones aparecen en Reports con el tipo de activación api, junto con las solicitudes de la API y las integraciones.
