キーと環境
Langsys のプロジェクトでは、2 種類の API キーが発行されます。どちらを使うかは、新しいフレーズを検出するのか（開発）、完成した翻訳を表示するだけなのか（本番）によって決まります。どちらのキーもダッシュボードで発行できます。手順はクイックスタートで説明しています。
2 つのキー、2 つの役割
| キーの種類 | できること | 使用できる環境 |
|---|---|---|
| 書き込み | 翻訳を取得し、さらに新しく見つかったフレーズをプロジェクトに登録します。 | 開発用/サーバー側専用。公開バンドルには含めないでください。 |
| 読み取り専用 | 翻訳の取得のみ可能です。登録や変更はできません。 | 本番環境/ブラウザ。クライアントコードに含めても安全です。 |
読み取り専用キーがブラウザで安全な理由。 このキーでは物理的に書き込みができません。悪用されても、ユーザーがすでに目にしている公開済みの翻訳を読み取られるだけです。これこそがキーを分ける最大の目的です。
一般的な流れ
- 書き込みキーを使って開発します。UI を構築していくと、新しいフレーズが検出・登録され、対象ロケールに機械翻訳されます。
- 文言が固まったら、デプロイ済みのアプリを読み取り専用キーに切り替えましょう。
- ユーザーが取得するのは完成したカタログです。ユーザーの手元にあるものでは、プロジェクトを変更できません。
# .env.local — development
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key # discovers + registers new phrases# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key # only fetches — safe to shipプロジェクトに含まれるもの
このキーはプロジェクトに対して認証を行い、そのプロジェクトがアプリの翻訳対象の範囲を定義します:
- ベースロケール — ソースのフレーズが書かれている言語。
- ターゲットロケールのセット — フレーズの機械翻訳先となるすべての言語。
- 機械翻訳の設定 — プロバイダーのティアと、新しいフレーズを自動翻訳するかどうか。
これらのデモをローカルで実行していますか？読み取り専用キーを使って、SDK を自分のインスタンスに接続してください。詳しくはプロジェクトの .env.example を参照してください。接続しない場合、パネルはデモモード（ソーステキストのみ）で動作します。