Schnellstart: Projekt & Schlüssel
Jeder Playground auf dieser Website läuft mit einem gemeinsamen Demoprojekt, sodass du ohne Konto alles ausprobieren kannst. Um deine eigene App zu übersetzen, brauchst du drei Dinge aus dem Langsys-Dashboard: ein Projekt, einen Schreibschlüssel und einen schreibgeschützten Schlüssel. Zwei Minuten, einmalig.
Die Einrichtung
- Melden Sie sich an unter app.langsys.dev – erstellen Sie ein Konto, falls Sie noch keines haben.
- Erstellen Sie ein Projekt. Wählen Sie die Basissprache (die Sprache, in der Ihre Quellphrasen verfasst sind) und die Zielsprachen, für die Sie Übersetzungen möchten. Kopieren Sie die Projekt-ID.
- Erstellen Sie zwei API-Keys für das Projekt: einen Write-Key und einen schreibgeschützten Key. Diese Trennung ist das gesamte Sicherheitsmodell – Keys & Umgebungen erklärt, warum.
- Tragen Sie sie in Ihre Umgebung ein und installieren Sie das SDK für Ihren Stack. Entwickeln Sie mit dem Schreibschlüssel, damit neue Phrasen beim Entwickeln registriert und maschinell übersetzt werden; ausgeliefert wird der schreibgeschützte Schlüssel.
# .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)Welcher Key gehört wohin? Der Browser erhält ausschließlich den schreibgeschützten Key – damit lassen sich Übersetzungen abrufen, mehr nicht, daher ist er in einem öffentlichen Bundle unbedenklich. Der Write-Key registriert neue Phrasen und gehört deshalb nur in die Entwicklung und auf Server.
Wählen Sie dann Ihr SDK
Jede SDK-Seite beginnt bei Installation und setzt genau diese Einrichtung voraus – Projekt-ID und Schlüssel in deiner Umgebung:
Frontend
TypeScript, React, Vue und Svelte, jeweils mit einem Live-Playground.
Backend
PHP und Laravel – die Seite kommt bereits lokalisiert an.
Meta-Frameworks
Next.js, Nuxt und SvelteKit – auf dem Server vorbefüllen, auf dem Client hydratisieren.
Neu bei den zugrunde liegenden Konzepten? Beginnen Sie mit Konzepte – die Phrase als Schlüssel, Token-Erkennung und der Locale-Speicher – und kehren Sie dann hierher zurück.