Cài đặt
Yêu cầu
- Node.js 20.11+ (native ESM)
- API key dịch thuật (xem bên dưới)
Cài đặt
- 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
Lấy API Key
Rosetta cần một backend dịch thuật. Hãy chọn một:
| Nhà cung cấp | Biến môi trường | Phù hợp nhất cho |
|---|---|---|
| OpenRouter (khuyên dùng) | OPENROUTER_API_KEY | Các dự án nhiều nội dung, Markdown, hơn 200 model |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | Các cặp key-value số lượng lớn (hơn 130 ngôn ngữ) |
- OpenRouter (recommended)
- Google Translate
OpenRouter cung cấp một API thống nhất cho hơn 200 model LLM. Có sẵn gói miễn phí.
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
Hoặc thêm vào .env.local:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
Phù hợp nhất cho: các dự án nhiều nội dung, dịch Markdown và các dự án cần bảo vệ nội dung theo ngữ cảnh (khối mã, shortcode, biến nội suy).
export GOOGLE_TRANSLATE_API_KEY=...
Phù hợp nhất cho: các cặp chuỗi key-value số lượng lớn (hơn 130 ngôn ngữ). Không khuyên dùng cho nội dung Markdown — Google Translate không nhận biết được các khối mã, shortcode hoặc biến nội suy.
:::tip Phát hiện thông minh
Nếu chỉ thiết lập GOOGLE_TRANSLATE_API_KEY (không có key OpenRouter), rosetta sẽ tự động chuyển sang Google Translate. Không cần thay đổi cấu hình.
:::
Xác minh cài đặt
npx i18n-rosetta --help
Bạn sẽ thấy danh sách các lệnh có sẵn. Bạn đã sẵn sàng cho phần Bắt đầu nhanh.