Hızlı başlangıç: proje ve anahtarlar
Bu sitedeki her deneme alanı ortak bir demo projeye karşı çalışır, böylece hesap açmadan keşfedebilirsiniz. Kendi uygulamanızı çevirmek için Langsys kontrol panelinden üç şeye ihtiyacınız var: bir proje, bir yazma anahtarı ve bir salt okunur anahtar. İki dakika, bir kereliğine.
Kurulum
- app.langsys.dev adresinde oturum açın; hesabınız yoksa bir hesap oluşturun.
- Bir proje oluşturun. Temel dili (kaynak ifadelerinizin yazıldığı dil) ve çeviri istediğiniz hedef dilleri seçin. Proje kimliğini kopyalayın.
- Proje için iki API anahtarı üretin: bir yazma anahtarı ve bir salt okunur anahtar. Bu ayrım tüm güvenlik modelinin temelidir — nedenini Anahtarlar ve ortamlar bölümünde açıklıyoruz.
- Bunları env dosyanıza ekleyin ve yığınınız için SDK'yı kurun. Geliştirirken yazma anahtarını kullanın; böylece yeni ifadeler siz geliştirdikçe kaydedilir ve makine çevirisiyle çevrilir; yayına ise salt okunur anahtarla çıkın.
# .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)Hangi anahtar nerede kullanılır? Tarayıcıya yalnızca salt okunur anahtar verilir — yalnızca çevirileri getirebilir, başka bir şey yapamaz; bu yüzden herkese açık bir pakette güvenle yer alabilir. Yazma anahtarı yeni ifadeleri kaydeder, bu nedenle yalnızca geliştirme ortamında ve sunucularda kullanılmalıdır.
Ardından SDK'nızı seçin
Her SDK sayfası Kurulum bölümüyle başlar ve tam olarak şu yapılandırmayı varsayar — proje kimliği ve anahtar ortam değişkenlerinizde:
Ön uç
TypeScript, React, Vue ve Svelte; her biri canlı bir deneme alanıyla.
Arka uç
PHP ve Laravel: sayfa zaten yerelleştirilmiş olarak gelir.
Meta çerçeveler
Next.js, Nuxt ve SvelteKit — sunucuda başlangıç verisini yükleyin, istemcide etkinleştirin.
Altta yatan fikirlere yeni misiniz? Kavramlar bölümüyle başlayın — ifade anahtardır, token keşfi ve yerel ayar deposu — sonra buraya dönün.