Провайдеры перевода

Compiler от Lingo.dev поддерживает несколько провайдеров перевода: от управляемого движка локализации Lingo.dev до прямых подключений к LLM-провайдерам и локальных моделей. Провайдеры настраиваются через опцию models, которая принимает либо строку с одним провайдером, либо объект, сопоставляющий пары локалей с конкретными провайдерами.

Движок Lingo.dev (рекомендуется)#

Движок локализации Lingo.dev — провайдер по умолчанию. Он отправляет переводы через управляемый пайплайн с динамическим выбором модели, автоматическими fallback-сценариями, применением глоссария и профилями тональности бренда.

{
  models: "lingo.dev",
}

Пройдите аутентификацию через CLI:

npx @lingo.dev/cli login

Или задайте API-ключ в .env:

LINGODOTDEV_API_KEY=your_key_here

Прямые LLM-провайдеры#

Подключитесь напрямую к любому поддерживаемому LLM-провайдеру, указав строку provider:model:

Один провайдер для всех локалей#

Укажите строку, чтобы использовать один провайдер для всех пар локалей:

{
  models: "openai:gpt-4o",
}

Ollama (локальные модели)#

Ollama запускает модели локально и не требует API-ключа. Установите Ollama, загрузите модель и выполните настройку:

{
  models: "ollama:llama3.2",
}

Сопоставление пар локалей#

Опция models принимает объект, который позволяет направлять определённые пары локалей к разным провайдерам. Ключи используют формат source:target с поддержкой wildcard (*):

{
  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
  },
}

Compiler сопоставляет пары локалей от наиболее конкретных к наименее конкретным:

Такое сопоставление помогает оптимизировать затраты и качество. Например, можно использовать быструю модель для европейских языков и модель с более сильной поддержкой CJK для восточноазиатских локалей.

Пользовательские промпты#

Опция prompt задаёт системный промпт для LLM, выполняющей перевод. Используйте {SOURCE_LOCALE} и {TARGET_LOCALE} как плейсхолдеры — compiler подставит вместо них фактические коды локалей во время перевода:

{
  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.",
}

Что дальше#