LLM プロバイダー
すべての翻訳パイプライン — translate-ui, translate-docs, translate-json, および translate-svg — は、同じプロバイダ非依存クライアントを介してLLMにテキストを送信します。これらのコマンドを実行する前に、ai-i18n-tools.config.jsonで少なくとも1つのプロバイダを設定し、環境または.envに対応するAPIキーを設定してください(組み込みのプリセットのうちOllamaを除く)。initは初期設定用のprovider / providersブロックを書き出しますが、アクティブなプリセットの認証情報は引き続き指定する必要があります。
設定で呼び出す API エンドポイントを一度設定します。すべての翻訳コマンドがその設定と同じ SQLite キャッシュを共有します。プロバイダーが試行するモデルは、別のステップです: AI モデル。
CLI は、トップレベルの provider キー (または、1 つだけ設定されている場合は providers の唯一のエントリ) からアクティブなプロバイダーを解決します。各プロバイダーブロックには、順序付けられた translationModels フォールバックチェーンがリストされています。組み込みのプリセットは baseUrl と API キー環境変数を自動的に継承します (必要に応じてプロバイダーごとにオーバーライドします)。
組み込みプロバイダー
プリセットプロバイダーキーには translationModels のみが必要です。ベース URL と API キーの環境変数は自動的に入力されます。
| プロバイダー | APIキー環境変数 | ベースURL |
|---|---|---|
alibaba | ALIBABA_API_KEY | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
anthropic | ANTHROPIC_API_KEY | https://api.anthropic.com/v1 |
apikeyfan | APIKEYFAN_API_KEY | https://api.apikey.fan/v1 |
cerebras | CEREBRAS_API_KEY | https://api.cerebras.ai/v1 |
cheaperinference | CHEAPERINFERENCE_API_KEY | https://api.cheaperinference.com/v1 |
deepseek | DEEPSEEK_API_KEY | https://api.deepseek.com |
gemini | GOOGLE_API_KEY | https://generativelanguage.googleapis.com/v1beta/openai |
groq | GROQ_API_KEY | https://api.groq.com/openai/v1 |
mistral | MISTRAL_API_KEY | https://api.mistral.ai/v1 |
nvidia | NVIDIA_API_KEY | https://integrate.api.nvidia.com/v1 |
ollama | (none) | http://localhost:11434/v1 |
openai | OPENAI_API_KEY | https://api.openai.com/v1 |
openrouter | OPENROUTER_API_KEY | https://openrouter.ai/api/v1 |
xai | XAI_API_KEY | https://api.x.ai/v1 |
プリセット以外のキーについては、baseUrl と apiKeyEnv を設定で明示的に設定します。
アクティブなプロバイダーのAPIキーを環境変数に設定するか、またはプロバイダーのAPIキーがまだ設定されていない場合は、ai-i18n-tools.config.json と同じディレクトリにある .env / .env.local に設定します。CLIは、それらのファイルから読み取った変数名を表示します。環境変数 を参照してください。
ゼロデータ保持 (より安価な推論)
providers.cheaperinference.zeroDataRetention はオプションであり、デフォルトではオフです。このプロジェクトがプロンプトを保持しないプロバイダーのみを介して送信する必要がある場合に設定します。
"cheaperinference": {
"zeroDataRetention": true,
"translationModels": ["gemini-2.5-flash", "deepseek-v4-flash"]
}このフラグがオンの場合、すべてのチャットリクエストに "zdr": true が含まれ、list-models、check-models、および suggest-models (ダッシュボードの「モデル」タブを含む) は GET /v1/models?zdr=true を読み取ります。そのカタログには、ゼロデータ保持リクエストが使用できるモデルが、ゼロデータ保持価格でリストされています。check-models は、そのカタログにないIDを無効として扱います。このフラグは、カタログに含まれていないモデルのルートを作成しません。そのIDを translationModels、uiModels、または localeModels から削除してください。
Cheaper Inference アカウントでゼロデータ保持が不要な場合は、このフラグをオフのままにしてください。アカウントで データ保護 がすでにオンになっている場合、Cheaper Inference は、ゼロデータ保持ルートがないモデルを拒否します。エラーはそのモデル名を指定します。アカウントポリシーを維持するには、zeroDataRetention を true に設定し、ゼロデータ保持カタログのモデルに切り替えてください。拒否されたモデルを維持するには、そのページでゼロデータ保持をオフにしてください。フォールバックチェーンは、次に設定されたモデルを試行します。
モデル
モデルの選択、フォールバックリスト、および suggest-models、check-models、list-models、bench-models は、AI モデル に記載されています。
複数のプロバイダー
複数のプロバイダーが設定されている場合は、トップレベルの provider キーを設定してデフォルトを選択します。設定を編集せずに実行ごとに切り替えます。
npx ai-i18n-tools translate-docs -P anthropic
npx ai-i18n-tools bench-models -P deepseek各プロバイダーブロックは独自の translationModels、オプションの uiModels および localeModels、maxTokens、temperature、requestTimeout (秒) または requestTimeoutMs を定義できます。プロバイダーのタイムアウトはトップレベルの requestTimeout / requestTimeoutMs を上書きします。従来のトップレベルの openrouter ブロックも引き続き受け付けられ、ロード時に providers.openrouter へ自動移行されます。
オプションのpricingとmodelPricingは、プロバイダーがusage.costを省略する場合に、100万トークンあたりのUSD(inputPerMTokensとoutputPerMTokens)を設定します。pricingはプロバイダー全体のデフォルトです。modelPricingエントリは、1つのモデルIDに対してこれを上書きします。OpenRouterとCheaper Inferenceはすでに呼び出しごとのコストを返すため、これらのプロバイダーでは両方とも設定しないでください。プロバイダーが報告したコストは、返されたとおりに保持されます。この金額は、翻訳の概要、usage、および使用量とコストに含まれます。
同じドキュメントに対して4つのプロバイダーを使用する実行可能な例(サンプルレートを含む):examples/multi-provider。
その他の参考資料
- AI モデル — ランク付けされたショートリスト、フォールバックリスト、およびモデルコマンド。
- 設定 —
providerとproviders— プリセットテーブル、カスタムエンドポイント、リクエストタイムアウト、コストレート、Cheaper Inference のゼロデータ保持、OpenRouter 固有の動作。 - アーキテクチャ — LLM クライアント — モデルのフォールバック、バッチ処理、コストレポートが内部でどのように機能するか。
- 環境変数 — API キーの環境変数とベース URL のオーバーライド。