Klucze i środowiska

Projekt Langsys wydaje dwa rodzaje kluczy API. To, którego użyjesz, zależy od tego, czy wykrywasz nowe frazy (środowisko deweloperskie), czy tylko wyświetlasz gotowe tłumaczenia (produkcja). Oba klucze tworzy się w panelu — przeprowadzi Cię przez to Szybki start.

Obejrzyj · 1:30 Klucze i środowiska

Dwa klucze, dwa zadania

Typ klucza	Co potrafi	Użyj w
Zapis	Pobieraj tłumaczenia i rejestruj nowo wykryte frazy w projekcie.	Środowisko deweloperskie / po stronie serwera. Nie umieszczaj go w publicznych paczkach.
Tylko do odczytu	Tylko pobieranie tłumaczeń. Nie można niczego rejestrować ani modyfikować.	Produkcja / przeglądarka. Można bezpiecznie umieszczać w kodzie klienckim.

Dlaczego klucz tylko do odczytu jest bezpieczny w przeglądarce. Fizycznie nie może zapisywać — najgorsze, co można z nim zrobić, to odczytać te same publiczne tłumaczenia, które i tak widzą Twoi użytkownicy. Na tym polega cały sens tego podziału.

Typowy przebieg pracy

Obejrzyj · 1:30 Klucze API w środowisku produkcyjnym

Programuj z użyciem klucza zapisu. Podczas budowania interfejsu nowe frazy są wykrywane, rejestrowane i automatycznie tłumaczone na docelowe języki.
Gdy treść się ustabilizuje, przełącz wdrożoną aplikację na klucz tylko do odczytu.
Użytkownicy pobierają gotowy katalog; nic, co posiadają, nie może zmienić Twojego projektu.

Programowanie

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

Produkcja

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

Co zawiera projekt

Obejrzyj · 2:24 Ustawienia Tłumacza AI

Klucz uwierzytelnia się względem projektu, który określa zakres tłumaczeń Twojej aplikacji:

język bazowy — język, w którym zapisane są Twoje frazy źródłowe;
zestaw języków docelowych — wszystkiego, na co frazy są tłumaczone maszynowo;
ustawienia tłumaczenia maszynowego — poziom dostawcy oraz to, czy nowe frazy są tłumaczone automatycznie.

Uruchamiasz te demonstracje lokalnie? Wskaż SDK własną instancję za pomocą klucza tylko do odczytu — zobacz plik .env.example w projekcie. W przeciwnym razie panele działają w trybie demo (tylko tekst źródłowy).