Tích hợp Luna Translator

Độ khó 🧩 Trung bình　|　Định dạng giao diện Tương thích OpenAI　|　base_url https://byesu.com/v1

Thông tin kết nối

Địa chỉ APIhttps://byesu.com/v1

Khóa APIsk-xxxxxxxxTạo trong bảng điều khiển →

Mô hìnhgpt-5.5

Định dạng API OpenAI tương thích · tên mô hình theo bảng điều khiển

LunaTranslator là một trình dịch GalGame / tiểu thuyết hình ảnh (visual novel) mã nguồn mở, hỗ trợ trích xuất văn bản qua HOOK, nhận dạng OCR và tích hợp mô hình lớn để dịch bằng AI. Khi kết nối nó với Byesu API, bạn có thể dùng các mô hình như gpt-5.5, claude-opus-4-8... để dịch văn bản trò chơi theo thời gian thực.

Trước khi bắt đầu

Trước tiên hãy vào Bảng điều khiển → Token để tạo một token API (có dạng sk-xxxx). Khi tạo, nhất định phải chọn đúng nhóm, vì nhóm quyết định bạn có thể gọi những mô hình nào và cách tính phí ra sao; xem chi tiết tại Chọn nhóm.

Bước 1: Tải về và cài đặt Luna Translator

Hãy truy cập Tài liệu chính thức của LunaTranslator để tải về phiên bản mới nhất, giải nén rồi chạy chương trình chính là xong (bản xanh không cần cài đặt cho Windows).

Bước 2: Cấu hình giao diện mô hình lớn

LunaTranslator cung cấp hai cách: «nhập một lần» và «cấu hình thủ công»; khuyến nghị thử cách một trước.

Cách một (nhanh nhất): Nhập một lần từ bảng điều khiển

1. Trong Bảng điều khiển Byesu, mở Cài đặt hệ thống → Cài đặt trò chuyện, thêm liên kết chuyển hướng trò chuyện như sau:

Liên kết cài đặt trò chuyện

{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }

2. Vào Bảng điều khiển → Quản lý Token, tìm token của bạn, nhấp vào mũi tên thả xuống bên phải mục «Trò chuyện», chọn LunaTranslator, trình duyệt sẽ tự động gọi ứng dụng khách và ghi cấu hình vào đó.
3. Trong LunaTranslator, mở Cài đặt → Cài đặt dịch → Mô hình lớn, tìm bản cấu hình giao diện vừa được tự động thêm vào.
4. Nhấp nút «Làm mới» bên cạnh ô thả xuống chọn mô hình để lấy danh sách mô hình khả dụng từ Byesu, chọn một mô hình (ví dụ gpt-5.5) rồi lưu lại.
5. Bật công tắc kích hoạt ở bên trái của bản cấu hình giao diện này.

Cách hai: Cấu hình thủ công

1. Trong Bảng điều khiển → Quản lý Token, sao chép API Key của bạn (sk-xxxx).
2. Trong LunaTranslator, mở Cài đặt → Cài đặt dịch → Mô hình lớn, nhấp «Thêm».
3. Sao chép một bản mẫu «Giao diện thông dụng cho mô hình lớn».
4. Điền các nội dung sau vào các trường của giao diện mới:

Trường	Giá trị cần điền
Địa chỉ giao diện API / base_url	https://byesu.com/v1
API Key	sk-xxxx (token của bạn)
Mô hình model	gpt-5.5 (hoặc chọn sau khi làm mới ở bước tiếp theo)

5. Nhấp «Làm mới» bên cạnh ô mô hình, rồi chọn mô hình muốn dùng từ danh sách thả xuống.

Đừng bỏ sót /v1 trong địa chỉ

LunaTranslator sử dụng giao diện tương thích OpenAI, base_url bắt buộc phải là https://byesu.com/v1 (kết thúc bằng /v1). Nếu điền thành https://byesu.com thì giao diện sẽ không nhận dạng được.

Bước 3: Kích hoạt và kiểm tra

1. Bật công tắc kích hoạt ở bên trái của bản cấu hình giao diện này.
2. Quay lại giao diện chính, trong phần công cụ dịch hãy chọn giao diện mô hình lớn này làm nguồn bản dịch.
3. Dùng HOOK hoặc OCR để bắt một đoạn văn bản trò chơi, xác nhận có thể trả về bản dịch tiếng Việt bình thường là đã tích hợp thành công.

Tham khảo các mô hình thường dùng:

• Ưu tiên tốc độ, hiệu quả chi phí cao: gpt-5.5
• Chất lượng dịch tinh tế hơn: claude-opus-4-8
• Văn bản dài / đa ngôn ngữ: gemini-3.1-pro-high

Bị kẹt?

• Báo lỗi 401 / xác thực thất bại: API Key điền sai hoặc dính khoảng trắng thừa, hãy sao chép lại sk-xxxx từ phần quản lý token. Xem Lỗi thường gặp #auth.
• Thông báo không có kênh khả dụng / mô hình không tồn tại: nhóm của token hiện tại không có mô hình đó, hãy đổi mô hình khác hoặc điều chỉnh nhóm. Xem Chọn nhóm và Lỗi thường gặp #no-channel.
• Không đủ hạn mức / số dư bằng 0: hạn ngạch của token đã cạn, hãy nạp tiền hoặc kiểm tra giới hạn hạn mức của token. Xem Lỗi thường gặp #balance.
• Làm mới danh sách mô hình thì trống rỗng: xác nhận base_url kết thúc bằng /v1 và token còn hiệu lực.

Xem thêm cách khắc phục tại Lỗi thường gặp.