Sleutels & omgevingen

Een Langsys-project geeft twee soorten API-sleutels uit. Welke je gebruikt, hangt ervan af of je nieuwe zinnen ontdekt (ontwikkeling) of alleen voltooide vertalingen toont (productie). Beide maak je aan in het dashboard; de Quickstart loopt er stap voor stap doorheen.

Bekijken · 1:30 Sleutels & omgevingen

Twee sleutels, twee taken

Sleuteltype	Kan	Gebruik het in
Schrijven	Haal vertalingen op en registreer nieuw ontdekte zinnen in het project.	Ontwikkeling / serverzijde. Houd hem buiten publieke bundels.
Alleen-lezen	Haalt alleen vertalingen op. Kan niets registreren of wijzigen.	Productie / de browser. Veilig te gebruiken in clientcode.

Waarom een alleen-lezensleutel veilig is in de browser. Hij kan fysiek niet schrijven — het ergste wat iemand ermee kan doen, is dezelfde publieke vertalingen lezen die je gebruikers al zien. Dat is precies het doel van de splitsing.

De typische werkwijze

Bekijken · 1:30 API-sleutels in productie

Ontwikkel met een schrijfsleutel. Terwijl je de UI bouwt, worden nieuwe frases ontdekt, geregistreerd en automatisch vertaald naar je doellocales.
Zodra de teksten vaststaan, schakel je de uitgerolde app over op een alleen-lezen key.
Gebruikers halen de afgewerkte catalogus op; niets wat zij in handen hebben kan je project wijzigen.

Ontwikkeling

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

Productie

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

Wat een project bevat

Bekijken · 2:24 Instellingen voor AI-vertaler

De sleutel authenticeert tegen een project, dat het vertaaluniversum van je app bepaalt:

een basistaalvariant — de taal waarin je bronzinnen zijn geschreven;
een set doellocales: alle talen waarin zinnen automatisch worden vertaald;
instellingen voor machinevertaling — het providerniveau en of nieuwe zinnen automatisch worden vertaald.

Draai je deze demo's lokaal? Richt de SDK op je eigen instantie met een alleen-lezensleutel — zie de .env.example van het project. Anders draaien de panelen in demomodus (alleen brontekst).