Lingo.dev CLI は、1つの設定項目だけでコードベースをローカライゼーションエンジンに接続できます。すべてのlingo.dev run呼び出しがエンジンを経由し、ブランドボイス、用語集、指示、モデル設定を自動で適用します。コードの変更も、新たな依存関係の追加も必要ありません。
何が変わるのか#
| 導入前 | 導入後 | |
|---|---|---|
| 翻訳パイプライン | Lingo.dev の標準パイプライン | 独自のローカライゼーションエンジン |
| ブランドボイス | なし | 対象ロケールごとに適用 |
| 用語集 | なし | リクエストごとに意味ベースでマッチング |
| 指示 | なし | 対象ロケールごとに適用 |
| モデル選択 | Lingo.dev のデフォルト | フォールバックを含む独自のモデル設定 |
| 品質レビュー | なし | 設定済みのAI評価者が自動実行 |
セットアップ#
1
i18n.json に engineId を追加する（任意）
特定のエンジンを指定するには、engineId フィールドを i18n.json の設定に追加します。エンジン ID はダッシュボードで確認でき、eng_ で始まります（例: eng_SxjMwMsfOIsvV1wh）。
json
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}そのほかの設定項目は変わりません。ソースロケール、ターゲット、バケットはそのまま使えます。engineId を省略すると、CLI は組織のデフォルトエンジンを使用します。
2
API キーを設定する
CLI は Lingo.dev API キーで認証します。環境変数として設定してください。
bash
export LINGO_API_KEY="your-api-key"または、~/.lingodotdevrc に保存することもできます。
ini
[auth.vnext]
apiKey = your-api-keyAPI キーはダッシュボードの API Keys ページから生成できます。
3
翻訳を実行する
bash
lingo.dev runCLI は翻訳リクエストをエンジンに送信し、結果をロケールファイルに書き戻します。そのたびに、ブランドボイス、用語集、指示、モデル設定が自動で適用されます。
設定リファレンス#
i18n.json#
| フィールド | 説明 |
|---|---|
engineId | 任意。エンジン ID（eng_...）を指定します。省略した場合は、組織のデフォルトエンジンが使用されます。 |
そのほかの i18n.json フィールド（version、locale、buckets）は、標準の CLI 設定と同じように動作します。
環境変数#
| 変数 | 必須 | デフォルト | 説明 |
|---|---|---|---|
LINGO_API_KEY | はい | - | Lingo.dev API キー |
LINGO_API_URL | いいえ | https://api.lingo.dev | カスタム API ベース URL（セルフホスト環境またはステージング用） |
期待できること#
CLI が生成するすべての翻訳は、エンジンのフルパイプラインを通ります。
- ブランドボイスがロケールごとにトーンや文体を調整
- 用語集項目が意味ベースのマッチングで用語を正確に統一
- 指示がロケール固有の言語ルールを適用
- モデル設定が適切な LLM を選択し、自動フォールバックも実行
- AI評価者が各リクエスト後に品質を自動評価
翻訳は、API や各種連携からのリクエストと並んで、トリガー種別 api として Reports に表示されます。
