快速入门：项目与密钥

本站的每个演示区都运行在共享的演示项目上，因此无需账号即可体验。若要翻译您自己的应用，您需要从Langsys 仪表板获取三样东西：一个项目、一个写入密钥和一个只读密钥。只需两分钟，一次搞定。

观看 · 4:13 从头到尾快速上手

设置

在 app.langsys.dev 登录——如果还没有账号，请先创建一个。
创建项目。选择基础语言环境（源短语所使用的语言）以及需要翻译的目标语言环境。复制项目 ID。
为项目生成两个 API 密钥:一个写入密钥和一个只读密钥。这种拆分就是整个安全模型的核心——密钥与环境会解释原因。
将它们放入你的环境变量，并为你的技术栈安装 SDK。开发时使用写入密钥，这样新短语会在你构建时自动登记并机器翻译；发布时使用只读密钥。

前端(浏览器)应用

# .env.local — development (Vite-style names; adjust the prefix to your bundler)
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 in the browser

后端（服务器端渲染）应用

# .env (Laravel, or your PHP app's environment)
LANGSYS_PROJECT_ID=your-project-id
LANGSYS_API_KEY=write-key            # server-side, so the write key can stay —
                                     # switch to read-only anywhere that must not
                                     # register phrases (e.g. a public sandbox)

哪个密钥用在哪里?浏览器只会获得只读密钥——它只能获取翻译,别无其他权限,因此放在公开的代码包中也很安全。写入密钥用于注册新短语,所以只能用于开发环境和服务器端。

然后选择您的 SDK

每个 SDK 页面都从安装开始,并假定您已完成以下设置——在环境变量中配置项目 ID 和密钥:

前端

支持 TypeScript、React、Vue 和 Svelte,每种都配有在线演练场。

后端

PHP 和 Laravel——页面送达时就已完成本地化。

元框架

Next.js、Nuxt 和 SvelteKit——在服务器端预置数据,在客户端完成激活(hydrate)。

对底层概念还不熟悉?先阅读核心概念——短语即键、令牌发现和语言环境存储——然后再回到这里。