Alpha
El Compiler de Lingo.dev está en fase alpha. 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 gestionado de Lingo.dev hasta conexiones directas con proveedores de LLM y modelos locales. Puedes configurar los proveedores con la opción models, que acepta una única cadena de proveedor o un objeto que asigna pares de idiomas a proveedores concretos.
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, alternativas automáticas en caso de fallo, aplicación del glosario y perfiles de voz de marca.
{
models: "lingo.dev",
}Autentícate con la CLI:
npx lingo.dev@latest loginO configura la clave de API 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 algún proveedor no está disponible. Los proveedores de LLM directos no incluyen estas funciones.
Proveedores de LLM directos#
Conéctate directamente a cualquier proveedor de LLM compatible indicando 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 único proveedor para todos los idiomas#
Define una cadena para usar un único proveedor en todos los pares de idiomas:
{
models: "openai:gpt-4o",
}Ollama (modelos locales)#
Ollama ejecuta modelos localmente sin necesidad de una clave de API. Instala Ollama, descarga un modelo y configúralo:
{
models: "ollama:llama3.2",
}Los modelos locales son útiles para trabajar sin conexión 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 de pares de idiomas#
La opción models acepta un objeto para dirigir pares de idiomas concretos 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 compara los pares de idiomas de la coincidencia más específica a la menos específica:
Coincidencia exacta
en:de solo coincide con traducciones del inglés al alemán.
Comodín en el idioma de destino
*:ja coincide con cualquier idioma de origen que se traduzca al japonés.
Comodín completo
*:* actúa como alternativa predeterminada para cualquier par que no tenga una coincidencia más específica.
Esta asignación te permite optimizar coste y calidad. Por ejemplo, puedes usar un modelo rápido para idiomas europeos y otro con mejor compatibilidad con CJK para idiomas de Asia Oriental.
Prompts personalizados#
La opción prompt establece un prompt del sistema para el LLM de traducción. Usa {SOURCE_LOCALE} y {TARGET_LOCALE} como marcadores de posición: el Compiler los sustituye por los códigos de idioma reales en el 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 solo se aplican a proveedores de LLM directos. Si usas el motor de localización de Lingo.dev, configura instructions y voz de marca desde el panel de Lingo.dev.
