翻訳プロバイダー

Lingo.dev Compiler は、マネージドな Lingo.dev ローカライゼーションエンジンから LLM プロバイダーへの直接接続、ローカルモデルまで、複数の翻訳プロバイダーに対応しています。プロバイダーは models オプションで設定でき、単一のプロバイダー文字列、またはロケールペアごとに利用するプロバイダーを指定するオブジェクトのいずれかを渡せます。

Lingo.dev エンジン（推奨）#

Lingo.dev のローカライゼーションエンジンはデフォルトのプロバイダーです。動的なモデル選択、自動フォールバック、glossary の適用、ブランドボイスプロファイルを備えたマネージドパイプラインを通じて翻訳を処理します。

{
  models: "lingo.dev",
}

CLI で認証します。

npx @lingo.dev/cli login

または、.env に API キーを設定します。

LINGODOTDEV_API_KEY=your_key_here

LLM プロバイダーへの直接接続#

対応する任意の LLM プロバイダーに直接接続するには、provider:model 文字列を指定します。

すべてのロケールで単一プロバイダーを使う#

すべてのロケールペアで 1 つのプロバイダーを使う場合は、文字列を設定します。

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

Ollama（ローカルモデル）#

Ollama なら、API キーなしでモデルをローカル実行できます。Ollama をインストールし、モデルを pull して、次のように設定します。

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

ロケールペアのマッピング#

models オプションでは、特定のロケールペアを異なるプロバイダーに振り分けるためのオブジェクトを指定できます。キーは source:target 形式で、ワイルドカード（*）にも対応しています。

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

次のステップ#