Conecta tu motor

La CLI de Lingo.dev conecta tu base de código con un motor de localización a través de la configuración de tu proyecto. Cada lingo push pasa por tu motor y aplica automáticamente tu voz de marca, glosario, reglas y configuración del 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	Aplicada por idioma de destino
Glosario	Ninguno	Coincidencia semántica en cada solicitud
Reglas	Ninguna	Incluidas por idioma de destino
Selección de modelo	Predeterminada 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#

Vincula tu motor

Ejecuta lingo link en la raíz de tu proyecto:

bash

lingo link

Elige (o crea) una organización y un motor de localización. link escribe orgId y engineId en .lingo/config.json; haz commit para que todas las ejecuciones usen el mismo motor. También puedes encontrar el ID de un motor en el panel; empieza con eng_ (por ejemplo, eng_SxjMwMsfOIsvV1wh).

Autentícate

bash

lingo login

Se abrirá un navegador para autenticarte y guardar una sesión. Para CI o usos no interactivos, pasa una clave de API en su lugar:

bash

lingo login --api-key lk_...

…o configúrala como variable de entorno:

bash

export LINGO_API_KEY="lk_..."

Genera una clave de API desde la página API Keys del panel.

Haz push

bash

lingo push

La CLI envía los archivos fuente a tu motor y guarda en el disco los resultados traducidos, aplicando automáticamente tu voz de marca, glosario, reglas y configuración del modelo.

Referencia de configuración#

`.lingo/config.json`#

Campo	Descripción
`orgId`	Organización propietaria del motor. Se configura con `lingo link`.
`engineId`	Motor que realiza la traducción (`eng_...`). Se configura con `lingo link`.

sourceLocale, targetLocales y files funcionan igual que en cualquier proyecto; consulta Configuración.

Variables de entorno#

Variable	Obligatoria	Predeterminada	Descripción
`LINGO_API_KEY`	Para CI	-	Tu clave de API de Lingo.dev (en lugar de `lingo login`)
`LINGO_API_URL`	No	`https://api.lingo.dev`	URL base de API personalizada (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 por idioma
Elementos del glosario garantizan una terminología precisa mediante coincidencia semántica
Las Reglas aplican reglas lingüísticas específicas de cada configuración regional
Configuraciones de modelo seleccionan el LLM adecuado con alternativas automáticas
AI Reviewers evalúan la calidad automáticamente después de cada solicitud

Las traducciones aparecen en Reports con el tipo de activador api, junto con las solicitudes de la API y las integraciones.

Siguientes pasos#

API Keys

Genera la clave de API para autenticar el CLI

Brand Voices

Configura cómo traduce tu motor según el idioma

Glossaries

Configura las reglas de terminología antes de tu primera ejecución

API Reference

Usa el mismo motor de forma programática

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	Coincidencia semántica en cada solicitud
Reglas	Ninguna	Incluidas por idioma de destino
Selección de modelo	Predeterminada 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#

Vincula tu motor

Ejecuta lingo link en la raíz de tu proyecto:

bash

lingo link

Autentícate

bash

lingo login

Se abrirá un navegador para autenticarte y guardar una sesión. Para CI o usos no interactivos, pasa una clave de API en su lugar:

bash

lingo login --api-key lk_...

…o configúrala como variable de entorno:

bash

export LINGO_API_KEY="lk_..."

Genera una clave de API desde la página API Keys del panel.

Haz push

bash

lingo push

La CLI envía los archivos fuente a tu motor y guarda en el disco los resultados traducidos, aplicando automáticamente tu voz de marca, glosario, reglas y configuración del modelo.

Referencia de configuración#

`.lingo/config.json`#

Campo	Descripción
`orgId`	Organización propietaria del motor. Se configura con `lingo link`.
`engineId`	Motor que realiza la traducción (`eng_...`). Se configura con `lingo link`.

sourceLocale, targetLocales y files funcionan igual que en cualquier proyecto; consulta Configuración.

Variables de entorno#

Variable	Obligatoria	Predeterminada	Descripción
`LINGO_API_KEY`	Para CI	-	Tu clave de API de Lingo.dev (en lugar de `lingo login`)
`LINGO_API_URL`	No	`https://api.lingo.dev`	URL base de API personalizada (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 por idioma
Elementos del glosario garantizan una terminología precisa mediante coincidencia semántica
Las Reglas aplican reglas lingüísticas específicas de cada configuración regional
Configuraciones de modelo seleccionan el LLM adecuado con alternativas automáticas
AI Reviewers evalúan la calidad automáticamente después de cada solicitud

Las traducciones aparecen en Reports con el tipo de activador api, junto con las solicitudes de la API y las integraciones.

Siguientes pasos#

API Keys

Genera la clave de API para autenticar el CLI

Brand Voices

Configura cómo traduce tu motor según el idioma

Glossaries

Configura las reglas de terminología antes de tu primera ejecución

API Reference

Usa el mismo motor de forma programática