빠른 시작: 프로젝트 및 키

이 사이트의 모든 플레이그라운드는 공유 데모 프로젝트에서 실행되므로 계정 없이도 둘러볼 수 있습니다. 직접 만든 앱을 번역하려면 Langsys 대시보드에서 프로젝트, 쓰기 키, 읽기 전용 키 이렇게 세 가지가 필요합니다. 한 번만 하면 되고, 2분이면 충분합니다.

시청 · 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와 키를 설정하세요:

빠른 시작: 프로젝트 및 키

설정

그런 다음 SDK를 선택하세요

프런트엔드

백엔드

메타 프레임워크