설치
요구 사항
- 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는 번역 백엔드가 필요해요. 하나를 선택해 주세요:
| 제공자 | 환경 변수 | 추천 대상 |
|---|---|---|
| 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
사용 가능한 명령어 목록이 표시될 거예요. 이제 빠른 시작을 진행할 준비가 되었어요.