← Tìm hiểu

Bắt đầu nhanh: dự án & khóa

Mọi sân chơi (playground) trên trang này đều chạy trên một dự án demo dùng chung, nên bạn có thể khám phá mà không cần tài khoản. Để dịch ứng dụng của riêng bạn, bạn cần ba thứ từ bảng điều khiển Langsys: một dự án, một khóa ghi và một khóa chỉ đọc. Chỉ hai phút, làm một lần.

Thiết lập

1. Đăng nhập tại app.langsys.dev — hãy tạo tài khoản nếu bạn chưa có.
2. Tạo một dự án. Chọn ngôn ngữ gốc (ngôn ngữ mà các cụm từ nguồn của bạn được viết) và các ngôn ngữ đích mà bạn muốn có bản dịch. Sao chép id dự án.
3. Tạo hai khóa API cho dự án: một khóa ghi và một khóa chỉ đọc. Việc tách khóa chính là toàn bộ mô hình bảo mật — Khóa & môi trường giải thích lý do.
4. Thêm chúng vào biến môi trường của bạn và cài SDK cho stack của bạn. Hãy phát triển bằng khóa ghi để các cụm từ mới được đăng ký và dịch máy ngay khi bạn xây dựng; khi phát hành thì dùng khóa chỉ đọc.

# .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)

Sau đó chọn SDK của bạn

Mỗi trang SDK bắt đầu từ Install và giả định chính xác thiết lập này — ID dự án và khóa nằm trong env của bạn:

Chưa quen với các khái niệm nền tảng? Hãy bắt đầu với Khái niệm — cụm từ chính là khóa, cơ chế phát hiện token và kho locale — rồi quay lại đây.