Chiavi e ambienti

Un progetto Langsys emette due tipi di chiave API. Quale usare dipende dal fatto che tu stia scoprendo nuove frasi (sviluppo) o semplicemente mostrando traduzioni già pronte (produzione). Entrambe vengono generate nella dashboard: la guida introduttiva ti accompagna passo dopo passo.

Guarda · 1:30 Chiavi e ambienti

Due chiavi, due compiti

Tipo di chiave	Cosa può fare	Usalo in
Scrivi	Recupera le traduzioni e registra nel progetto le frasi appena individuate.	Sviluppo / lato server. Tienila fuori dai bundle pubblici.
Sola lettura	Recupera solo le traduzioni. Non può registrare né modificare nulla.	Produzione / browser. Sicura da distribuire nel codice client.

Perché una chiave di sola lettura è sicura nel browser. Fisicamente non può scrivere: il massimo che si può fare con essa è leggere le stesse traduzioni pubbliche che i tuoi utenti vedono già. È proprio questo lo scopo della separazione.

Il flusso tipico

Guarda · 1:30 Chiavi API in produzione

Sviluppa con una chiave di scrittura. Mentre costruisci l'interfaccia, le nuove frasi vengono rilevate, registrate e tradotte automaticamente nelle lingue di destinazione.
Una volta definiti i testi, passa l'app distribuita a una chiave di sola lettura.
Gli utenti recuperano il catalogo finale; nulla di ciò che hanno in mano può modificare il tuo progetto.

Sviluppo

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

Produzione

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

Che cosa contiene un progetto

Guarda · 2:24 Impostazioni del traduttore AI

La chiave si autentica su un progetto, che definisce l'universo di traduzione della tua app:

una lingua di base — la lingua in cui sono scritte le tue frasi di origine;
un insieme di lingue di destinazione: tutte quelle in cui le frasi vengono tradotte automaticamente;
impostazioni di traduzione automatica: il livello del provider e se le nuove frasi vengono tradotte automaticamente.

Stai eseguendo queste demo in locale? Punta l'SDK alla tua istanza con una chiave di sola lettura: consulta il file .env.example del progetto. In caso contrario, i pannelli funzionano in modalità demo (solo testo di origine).