← Aprender

Início rápido: projeto e chaves

Todos os playgrounds deste site rodam em um projeto de demonstração compartilhado, então você pode explorar sem criar uma conta. Para traduzir o seu próprio app, você precisa de três coisas no painel da Langsys: um projeto, uma chave de escrita e uma chave somente leitura. Dois minutos, uma única vez.

A configuração

1. Entre em app.langsys.dev — crie uma conta se você ainda não tiver uma.
2. Crie um projeto. Escolha o idioma base (o idioma em que suas frases de origem são escritas) e os idiomas de destino para os quais você quer traduções. Copie o ID do projeto.
3. Gere duas chaves de API para o projeto: uma chave de escrita e uma chave somente leitura. Essa separação é todo o modelo de segurança — Chaves e ambientes explica por quê.
4. Coloque-as no seu env e instale o SDK para a sua stack. Desenvolva com a chave de escrita para que as novas frases sejam registradas e traduzidas automaticamente durante o desenvolvimento; publique com a chave somente leitura.

# .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)

Depois, escolha seu SDK

Cada página do SDK começa em Instalação e pressupõe exatamente esta configuração — ID do projeto e chave no seu env:

Novo nos conceitos por trás de tudo? Comece por Conceitos — a frase é a chave, a descoberta de tokens e o repositório de locales — e depois volte aqui.