Chaves e ambientes

Um projeto do Langsys emite dois tipos de chave de API. Qual usar depende de você estar descobrindo novas frases (desenvolvimento) ou apenas exibindo traduções prontas (produção). As duas são geradas no painel — o Guia de início rápido mostra o passo a passo.

Assistir · 1:30 Chaves e ambientes

Duas chaves, duas funções

Tipo de chave	Pode fazer	Use em
Escrever	Busque traduções e registre no projeto as frases recém-descobertas.	Desenvolvimento / lado do servidor. Mantenha-a fora dos bundles públicos.
Somente leitura	Apenas busca traduções. Não pode registrar nem modificar nada.	Produção / o navegador. Seguro para incluir no código do cliente.

Por que uma chave somente leitura é segura no navegador. Ela fisicamente não consegue escrever — o pior que alguém pode fazer com ela é ler as mesmas traduções públicas que seus usuários já veem. Esse é o objetivo da separação.

O fluxo típico

Assistir · 1:30 Chaves de API em produção

Desenvolva com uma chave de escrita. Conforme você constrói a interface, as novas frases são descobertas, registradas e traduzidas automaticamente para os seus idiomas de destino.
Quando o texto estiver definitivo, troque o app publicado para uma chave somente leitura.
Os usuários buscam o catálogo finalizado; nada do que eles têm em mãos pode alterar o seu projeto.

Desenvolvimento

# .env.local — development
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key   # discovers + registers new phrases

Produção

# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key   # only fetches — safe to ship

O que um projeto contém

Assistir · 2:24 Configurações do Tradutor de IA

A chave se autentica em um projeto, que define o universo de tradução do seu app:

um idioma base — o idioma em que suas frases de origem são escritas;
um conjunto de localidades de destino: todos os idiomas para os quais as frases são traduzidas por máquina;
configurações de tradução automática — o nível do provedor e se as novas frases são traduzidas automaticamente.

Executando estas demos localmente? Aponte o SDK para a sua própria instância com uma chave somente leitura — veja o arquivo .env.example do projeto. Caso contrário, os painéis são executados em modo de demonstração (somente o texto original).