Alfa
El Compiler de Lingo.dev está en alfa. Es inestable, no se recomienda para producción y las API pueden cambiar entre versiones.
El Compiler de Lingo.dev es compatible con varios proveedores de traducción, desde el motor de localización administrado de Lingo.dev hasta conexiones directas con proveedores LLM y modelos locales. Los proveedores se configuran con la opción models, que admite una sola cadena de proveedor o un objeto que asigna pares de idiomas a proveedores específicos.
Motor de Lingo.dev (recomendado)#
El motor de localización de Lingo.dev es el proveedor predeterminado. Gestiona las traducciones a través de un pipeline administrado con selección dinámica de modelos, mecanismos de respaldo automáticos, aplicación del glosario y perfiles de voz de marca.
{
models: "lingo.dev",
}Autentícate desde la CLI:
npx lingo.dev@latest loginO configura la API key en .env:
LINGODOTDEV_API_KEY=your_key_herePor qué usar el motor de Lingo.dev
El motor de localización selecciona el modelo óptimo para cada par de idiomas, aplica tus reglas de glossary y voz de marca, y recurre a modelos alternativos si un proveedor no está disponible. Los proveedores LLM directos no incluyen estas funciones.
Proveedores LLM directos#
Conéctate directamente a cualquier proveedor LLM compatible especificando una cadena provider:model:
| Proveedor | Formato del modelo | Variable de entorno | Ejemplo |
|---|---|---|---|
| OpenAI | openai:<model> | OPENAI_API_KEY | openai:gpt-4o |
| Anthropic | anthropic:<model> | ANTHROPIC_API_KEY | anthropic:claude-3-5-sonnet |
google:<model> | GOOGLE_API_KEY | google:gemini-2.0-flash | |
| Groq | groq:<model> | GROQ_API_KEY | groq:llama-3.3-70b-versatile |
| Mistral | mistral:<model> | MISTRAL_API_KEY | mistral:mistral-large |
| OpenRouter | openrouter:<model> | OPENROUTER_API_KEY | openrouter:anthropic/claude-3.5-sonnet |
| Ollama | ollama:<model> | Ninguna (local) | ollama:llama3.2 |
Un solo proveedor para todos los idiomas#
Define una cadena para usar un mismo proveedor en todos los pares de idiomas:
{
models: "openai:gpt-4o",
}Ollama (modelos locales)#
Ollama ejecuta los modelos localmente, sin necesidad de API key. Instala Ollama, descarga un modelo y configúralo:
{
models: "ollama:llama3.2",
}Los modelos locales son útiles para desarrollo offline y para equipos que no pueden enviar contenido a API externas. La calidad de la traducción varía según el tamaño del modelo: los modelos más grandes suelen ofrecer resultados más precisos.
Asignación por pares de idiomas#
La opción models acepta un objeto para dirigir pares de idiomas específicos a distintos proveedores. Las claves usan el formato source:target y admiten comodines (*):
{
models: {
"*:*": "lingo.dev", // Default for all pairs
"*:ja": "anthropic:claude-3-5-sonnet", // Japanese via Anthropic
"*:zh-Hans": "anthropic:claude-3-5-sonnet", // Simplified Chinese via Anthropic
"en:de": "openai:gpt-4o", // English-to-German via OpenAI
},
}El Compiler hace coincidir los pares de idiomas de lo más específico a lo menos específico:
Coincidencia exacta
en:de coincide únicamente con traducciones de inglés a alemán.
Comodín de destino
*:ja coincide con cualquier idioma de origen que se traduzca al japonés.
Comodín total
*:* funciona como respaldo para cualquier par que no tenga una coincidencia más específica.
Esta asignación te permite optimizar costo y calidad. Por ejemplo, puedes usar un modelo rápido para idiomas europeos y otro con mejor soporte para CJK en idiomas de Asia oriental.
Prompts personalizados#
La opción prompt define un prompt de sistema para el LLM de traducción. Usa {SOURCE_LOCALE} y {TARGET_LOCALE} como marcadores de posición: el Compiler los reemplaza por los códigos de idioma reales al momento de traducir:
{
prompt: "You are translating a SaaS application UI from {SOURCE_LOCALE} to {TARGET_LOCALE}. Keep translations concise. Preserve technical terms in English. Use formal register.",
}Los prompts personalizados se aplican solo a proveedores LLM directos. Si usas el motor de localización de Lingo.dev, configura instructions y voz de marca desde el panel de Lingo.dev.
