密钥与环境
一个 Langsys 项目会签发两种 API 密钥。使用哪一种，取决于您是在发现新短语（开发阶段），还是仅显示已完成的翻译（生产阶段）。两种密钥都在控制台中生成——快速入门会带您逐步完成。
两个密钥,两项职责
| 键类型 | 可以做到 | 适用于 |
|---|---|---|
| 写入 | 获取翻译并将新发现的短语登记到项目中。 | 用于开发/服务器端。请勿放入公开的打包文件中。 |
| 只读 | 仅获取翻译。无法注册或修改任何内容。 | 生产环境 / 浏览器。可放心随客户端代码发布。 |
为什么只读密钥在浏览器中是安全的。它在技术上无法写入——任何人用它最多只能读取用户本来就能看到的公开翻译。这正是拆分密钥的意义所在。
典型流程
- 使用写入密钥进行开发。在构建界面的过程中,新短语会被发现、登记,并机器翻译为你的目标语言区域。
- 文案定稿后，请将已部署的应用切换为只读密钥。
- 用户获取的是已完成的目录；他们持有的任何内容都无法更改您的项目。
# .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。否则，这些面板将以演示模式运行（仅显示源文本）。