Anahtarlar ve ortamlar
Bir Langsys projesi iki tür API anahtarı verir. Hangisini kullanacağınız, yeni ifadeleri keşfetmenize (geliştirme) mi yoksa yalnızca tamamlanmış çevirileri göstermenize (üretim) mi bağlıdır. İkisi de panoda oluşturulur; Hızlı Başlangıç bunu adım adım anlatır.
İki anahtar, iki görev
| Anahtar türü | Yapabilir | Şurada kullanın: |
|---|---|---|
| Yazma | Çevirileri getirin ve yeni keşfedilen ifadeleri projeye kaydedin. | Geliştirme / sunucu tarafı. Herkese açık paketlerin dışında tutun. |
| Salt okunur | Yalnızca çevirileri getirir. Hiçbir şeyi kaydedemez veya değiştiremez. | Üretim ortamı / tarayıcı. İstemci kodunda göndermek güvenlidir. |
Salt okunur anahtar tarayıcıda neden güvenlidir? Fiziksel olarak yazamaz — onunla yapılabilecek en kötü şey, kullanıcılarınızın zaten gördüğü herkese açık çevirileri okumaktır. Ayrımın tüm amacı da bu.
Tipik akış
- Bir yazma anahtarı ile geliştirin. Arayüzü oluştururken yeni ifadeler keşfedilir, kaydedilir ve hedef dillerinize makine çevirisiyle çevrilir.
- Metin oturduktan sonra, yayındaki uygulamayı salt okunur anahtara geçirin.
- Kullanıcılar hazır kataloğu getirir; ellerindeki hiçbir şey projenizi değiştiremez.
# .env.local — development
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 Bir projenin içerdikleri
Anahtar, uygulamanızın çeviri evrenini tanımlayan bir projeye karşı kimlik doğrular:
- bir temel dil — kaynak ifadelerinizin yazıldığı dil;
- bir hedef yerel ayarlar kümesi — ifadelerin makine çevirisiyle çevrildiği tüm diller;
- makine çevirisi ayarları: sağlayıcı katmanı ve yeni ifadelerin otomatik çevrilip çevrilmeyeceği.
Bu demoları yerel olarak mı çalıştırıyorsunuz? SDK'yı salt okunur bir anahtarla kendi örneğinize yönlendirin — projenin .env.example dosyasına bakın. Aksi halde paneller demo modunda çalışır (yalnızca kaynak metin).