Panduan Cepat: proyek & key
Setiap playground di situs ini berjalan pada proyek demo bersama, jadi Anda bisa menjelajah tanpa akun. Untuk menerjemahkan aplikasi Anda sendiri, Anda memerlukan tiga hal dari dasbor Langsys: sebuah proyek, kunci tulis, dan kunci hanya-baca. Dua menit saja, cukup sekali.
Penyiapan
- Masuk di app.langsys.dev — buat akun jika Anda belum punya.
- Buat proyek. Pilih locale dasar (bahasa tempat frasa sumber Anda ditulis) dan locale target yang Anda inginkan terjemahannya. Salin id proyek.
- Buat dua kunci API untuk proyek: satu kunci tulis dan satu kunci hanya-baca. Pemisahan ini adalah seluruh model keamanannya — Kunci & lingkungan menjelaskan alasannya.
- Masukkan ke env Anda dan pasang SDK untuk stack Anda. Kembangkan dengan key tulis agar frasa baru terdaftar dan diterjemahkan otomatis saat Anda membangun; rilis dengan key hanya-baca.
# .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)Kunci mana untuk apa? Browser hanya akan menerima kunci hanya-baca — kunci ini hanya bisa mengambil terjemahan dan tidak bisa melakukan hal lain, sehingga aman berada di bundel publik. Kunci tulis mendaftarkan frasa baru, jadi hanya boleh digunakan di lingkungan pengembangan dan di server.
Lalu pilih SDK Anda
Setiap halaman SDK dimulai dari Install dan mengasumsikan persis pengaturan ini — id proyek dan kunci ada di env Anda:
Frontend
TypeScript, React, Vue, dan Svelte, masing-masing dengan playground langsung.
Backend
PHP dan Laravel — halaman tiba dalam keadaan sudah dilokalkan.
Meta-framework
Next.js, Nuxt, dan SvelteKit — isi data awal di server, lalu hydrate di klien.
Baru mengenal konsep dasarnya? Mulailah dengan Konsep — frasa sebagai kunci, penemuan token, dan penyimpanan locale — lalu kembali ke sini.