El CLI de Lingo.dev conecta tu base de código a un motor de localización con un único campo de configuración. Cada llamada a lingo.dev run pasa por tu motor, aplicando automáticamente tu voz de marca, glosario, instrucciones y configuración de modelo. Sin cambios en el código ni nuevas dependencias.
Qué cambia#
| Antes | Después | |
|---|---|---|
| Flujo de traducción | Flujo predeterminado de Lingo.dev | Tu motor de localización |
| Voz de marca | Ninguna | Aplicada por idioma de destino |
| Glosario | Ninguno | Emparejado semánticamente en cada solicitud |
| Instrucciones | Ninguna | Incluidas por idioma de destino |
| Selección de modelo | Predeterminado de Lingo.dev | Tu configuración de modelo con alternativas |
| Evaluación de calidad | Ninguna | Tus evaluadores de IA configurados se ejecutan automáticamente |
Configuración#
Añade engineId a i18n.json (opcional)
Para usar un motor concreto, añade el campo engineId a tu configuración de i18n.json. Encontrarás el ID de tu motor en el panel: empieza por eng_ (p. ej., 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 y buckets. Si omites engineId, el CLI usa el motor predeterminado de tu organización.
Configura tu clave de API
El CLI se autentica con tu clave de API de Lingo.dev. Defínela como variable de entorno:
export LINGO_API_KEY="your-api-key"O guárdala de forma persistente en ~/.lingodotdevrc:
[auth.vnext]
apiKey = your-api-keyGenera una clave de API desde la página API Keys del panel.
Ejecuta las traducciones
lingo.dev runEl CLI envía las 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 exactamente igual que en la configuración estándar del CLI.
Variables de entorno#
| Variable | Obligatoria | Predeterminado | Descripción |
|---|---|---|---|
LINGO_API_KEY | Sí | - | Tu clave de API de Lingo.dev |
LINGO_API_URL | No | https://api.lingo.dev | URL base de API personalizada (para entornos autohospedados o de staging) |
Qué puedes esperar#
Cada traducción que produce el CLI pasa por todo el flujo de tu motor:
- La voz de marca define el tono y la formalidad según el idioma
- Los elementos del glosario garantizan una terminología exacta mediante emparejamiento semántico
- Las instrucciones aplican reglas lingüísticas específicas de cada idioma
- Las configuraciones de modelo seleccionan el LLM adecuado con alternativas automáticas
- Los 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.
