Kunci & lingkungan

Proyek Langsys menerbitkan dua jenis kunci API. Mana yang Anda gunakan bergantung pada apakah Anda sedang menemukan frasa baru (pengembangan) atau hanya menampilkan terjemahan yang sudah jadi (produksi). Keduanya dibuat di dasbor — Panduan Memulai menjelaskan langkah-langkahnya.

Tonton · 1:30 Kunci & lingkungan

Dua kunci, dua tugas

Tipe kunci	Bisa dilakukan	Gunakan di
Tulis	Ambil terjemahan dan daftarkan frasa yang baru ditemukan ke dalam proyek.	Pengembangan / sisi server. Jangan sertakan dalam bundel publik.
Hanya-baca	Hanya mengambil terjemahan. Tidak dapat mendaftarkan atau mengubah apa pun.	Produksi / browser. Aman disertakan dalam kode klien.

Mengapa kunci hanya-baca aman di browser. Kunci ini secara fisik tidak bisa menulis — hal terburuk yang bisa dilakukan dengannya hanyalah membaca terjemahan publik yang sama dengan yang sudah dilihat pengguna Anda. Itulah inti dari pemisahan ini.

Alur yang umum

Tonton · 1:30 Kunci API di lingkungan produksi

Kembangkan dengan write key. Saat Anda membangun UI, frasa baru ditemukan, didaftarkan, dan diterjemahkan secara otomatis oleh mesin ke locale target Anda.
Setelah teksnya final, ganti aplikasi yang sudah di-deploy ke key hanya-baca.
Pengguna mengambil katalog yang sudah jadi; tidak ada yang mereka pegang yang dapat mengubah proyek Anda.

Pengembangan

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

Produksi

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

Isi sebuah proyek

Tonton · 2:24 Pengaturan Penerjemah AI

Kunci ini diautentikasi terhadap sebuah proyek, yang mendefinisikan cakupan terjemahan untuk aplikasi Anda:

sebuah locale dasar — bahasa tempat frasa sumber Anda ditulis;
kumpulan locale target — semua bahasa tujuan terjemahan mesin untuk frasa;
pengaturan terjemahan mesin — tingkat penyedia dan apakah frasa baru diterjemahkan secara otomatis.

Menjalankan demo ini secara lokal? Arahkan SDK ke instance Anda sendiri dengan kunci hanya-baca — lihat .env.example milik proyek. Jika tidak, panel berjalan dalam mode demo (hanya teks sumber).