インストール
要件
- Node.js 20.11+ (ネイティブESM)
- 翻訳APIキー (詳細は後述)
インストール
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev i18n-rosetta
npx i18n-rosetta sync
pnpm add -D i18n-rosetta
yarn add --dev i18n-rosetta
APIキーの取得
Rosettaには翻訳バックエンドが必要です。以下から1つ選択してください:
| プロバイダー | 環境変数 | 最適な用途 |
|---|---|---|
| OpenRouter (推奨) | OPENROUTER_API_KEY | コンテンツの多いプロジェクト、Markdown、200以上のモデル |
| Gemini (無料枠) | GEMINI_API_KEY | 無料で開始、高品質 |
| OpenAI | OPENAI_API_KEY | GPT-4oへの直接アクセス |
| Anthropic | ANTHROPIC_API_KEY | Claudeへの直接アクセス、ニュアンスのあるテキスト |
| DeepL | DEEPL_API_KEY | ヨーロッパ言語、丁寧さの指定機能 |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | 大量のキーバリューペア、130以上の言語 |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure、100以上の言語 |
| LibreTranslate | LIBRETRANSLATE_API_URL | セルフホスト、プライバシー重視 |
- OpenRouter (recommended)
- Google Translate
OpenRouterは、200以上のLLMモデルに対応した統合APIを提供しています。無料枠も利用可能です。
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
または、.env.localに追加します:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
最適な用途: コンテンツの多いプロジェクト、Markdownの翻訳、およびコンテンツを認識した保護（コードブロック、ショートコード、補間変数など）が必要なプロジェクト。
export GOOGLE_TRANSLATE_API_KEY=...
最適な用途: 大量のキーバリュー文字列ペア（130以上の言語）。Markdownコンテンツには推奨されません — Google Translateはコードブロック、ショートコード、補間変数を認識しません。
:::tip スマート検出
GOOGLE_TRANSLATE_API_KEYのみが設定されている場合（OpenRouterキーがない場合）、rosettaは自動的にGoogle Translateに切り替わります。設定の変更は必要ありません。
:::
インストールの確認
npx i18n-rosetta --help
利用可能なコマンドのリストが表示されるはずです。これでクイックスタートに進む準備が整いました。