Schlüssel & Umgebungen

Ein Langsys-Projekt stellt zwei Arten von API-Schlüsseln aus. Welchen Sie verwenden, hängt davon ab, ob Sie neue Phrasen entdecken (Entwicklung) oder nur fertige Übersetzungen anzeigen (Produktion). Beide werden im Dashboard erstellt – die Schnellstartanleitung führt Sie durch die Schritte.

Ansehen · 1:30 Schlüssel & Umgebungen

Zwei Schlüssel, zwei Aufgaben

Schlüsseltyp	Kann das	Verwendung in
Schreiben	Übersetzungen abrufen und neu entdeckte Phrasen im Projekt registrieren.	Entwicklung / serverseitig. Aus öffentlichen Bundles heraushalten.
Schreibgeschützt	Ruft nur Übersetzungen ab. Kann nichts registrieren oder ändern.	Produktion / Browser. Unbedenklich im Client-Code einsetzbar.

Warum ein schreibgeschützter Key im Browser unbedenklich ist. Er kann physisch nicht schreiben – das Schlimmste, was man damit tun kann, ist, dieselben öffentlichen Übersetzungen zu lesen, die Ihre Nutzer ohnehin sehen. Genau darin liegt der Sinn der Trennung.

Der typische Ablauf

Ansehen · 1:30 API-Schlüssel in der Produktion

Entwickle mit einem Schreibschlüssel. Während du die Benutzeroberfläche baust, werden neue Ausdrücke erkannt, registriert und maschinell in deine Ziel-Locales übersetzt.
Sobald der Text feststeht, stellen Sie die bereitgestellte App auf einen schreibgeschützten Schlüssel um.
Nutzer rufen den fertigen Katalog ab; nichts, was sie besitzen, kann dein Projekt verändern.

Entwicklung

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

Produktion

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

Was ein Projekt enthält

Ansehen · 2:24 Einstellungen des KI-Übersetzers

Der Schlüssel authentifiziert sich gegenüber einem Projekt, das den Übersetzungsumfang Ihrer App festlegt:

eine Basissprache – die Sprache, in der Ihre Quellphrasen verfasst sind;
eine Reihe von Ziel-Locales – alles, wohin Phrasen maschinell übersetzt werden;
Einstellungen für maschinelle Übersetzung – die Anbieterstufe und ob neue Phrasen automatisch übersetzt werden.

Sie führen diese Demos lokal aus? Richten Sie das SDK mit einem schreibgeschützten Schlüssel auf Ihre eigene Instanz aus – siehe die .env.example des Projekts. Andernfalls laufen die Panels im Demomodus (nur Quelltext).