Nhà cung cấp dịch thuật thuần túy

Nhà cung cấp dịch thuần là gì, Read Frog hỗ trợ những nhà cung cấp nào, mỗi bên cần khai gì, và khi nào nên chọn nó thay vì một nhà cung cấp LLM.

Nhà cung cấp dịch thuần là gì

Một nhà cung cấp dịch thuần chỉ làm một việc: bạn gửi văn bản đi, nó gửi bản dịch về. Không có mô hình để chọn, không có câu lệnh để viết, và cũng không có hội thoại. Read Frog gom chúng vào nhóm Nhà cung cấp dịch thuật thuần túy trong Cài đặt → Nhà cung cấp API → Thêm nhà cung cấp.

Một nhà cung cấp LLM dịch được là vì nó được yêu cầu dịch. Chính bước thêm vào ấy làm cho ngữ cảnh trang, cách bạn tự viết câu lệnh và bảng thuật ngữ trở nên khả thi — và cũng chính nó khiến việc dịch tốn nhiều token hơn, thường là chậm hơn.

Chúng không làm được gì

Nhà cung cấp dịch thuần có thể được giao cho dịch trang, phụ đề video, dịch thanh công cụ chọn và dịch đầu vào. Nhưng chúng không mang được bất cứ thứ gì phụ thuộc vào câu lệnh:

Ngữ cảnh thông minh AI không có câu lệnh nào để bổ sung vào, nên thiết lập này không tác động gì tới các nhà cung cấp đó.
Câu lệnh dịch cá nhân hóa bị làm mờ trong cửa sổ bật lên khi nhà cung cấp đang chọn không phải LLM.
Hành động AI tùy chỉnh và gợi ý ghi chú cần một nhà cung cấp LLM và sẽ không nhận loại này.
AI phân đoạn phụ đề bị bỏ qua; phụ đề được dịch theo từng câu đúng như lúc chúng tới.
Thuật ngữ bị bỏ qua. Bảng thuật ngữ đi bên trong câu lệnh hệ thống, nên nó chỉ tới được phần dịch bằng LLM.

Nếu bảng thuật ngữ bỗng không còn tác dụng trên một trang, hãy kiểm tra xem tính năng đó đang dùng nhà cung cấp nào. Mỗi tính năng tự chọn nhà cung cấp riêng, nên dịch trang có thể đã sang DeepL trong khi thanh công cụ chọn vẫn còn ở một LLM.

Nhóm này có những nhà cung cấp nào

DeepL

API chính thức của DeepL. Nó chỉ cần một API Key và không cần gì khác — không có ô Base URL, vì Read Frog tự chọn endpoint Free hay Pro dựa vào dạng khóa của bạn. Xem DeepL để biết chi tiết và cách nó xử lý mã ngôn ngữ.

DeepLX

Một API tương thích DeepL nhưng không chính thức. Nó cần một Base URL, còn API key chỉ cần khi thực thể của bạn đòi, nên một thực thể công khai miễn phí vẫn chạy được với ô khóa để trống. Base URL có thể chứa chỗ giữ vị trí {{apiKey}} khi nhà cung cấp của bạn muốn token nằm ở chỗ khác ngoài đường dẫn. Xem DeepLX.

Google Translate và Microsoft Translator

Hai cái này thuộc cùng họ nhưng không cần thiết lập gì cả: chúng có sẵn ở trạng thái đã thêm và đã bật, không có thông tin đăng nhập nào để khai, và cũng không xóa được. Chính vì vậy bạn sẽ không thấy chúng trong hộp thoại Thêm nhà cung cấp.

Microsoft Translator không dùng chung được với chế độ trang Chỉ bản dịch. Endpoint của nó không giữ lại cấu trúc thẻ, nên Read Frog chặn hẳn tổ hợp này thay vì để nó làm hỏng trang.

Thêm và bật một nhà cung cấp

Mở trang cài đặt của Read Frog và vào Nhà cung cấp API.

Bấm Thêm nhà cung cấp rồi chọn một nhà cung cấp trong nhóm Nhà cung cấp dịch thuật thuần túy.

Khai những ô mà nhà cung cấp đó hiện ra — API key cho DeepL, một Base URL (và khóa nếu cần) cho DeepLX.

Dùng Kiểm tra kết nối cạnh ô API Key rồi đợi kết quả.

Bật công tắc Bật, sau đó giao nhà cung cấp cho một tính năng trong phần Nhà cung cấp tính năng.

Một nhà cung cấp đã thêm nhưng chưa bật sẽ không xuất hiện trong các ô chọn theo tính năng. Giao nó cho một tính năng ngay trong trình chỉnh sửa của chính nó thì Read Frog bật luôn giúp bạn.

Kiểm tra kết nối

Kiểm tra kết nối không phải một lệnh ping — nó dịch từ Hi bằng đúng thiết lập thật của bạn, nên dấu tích xanh có nghĩa là chính cấu hình này đã tạo ra được một bản dịch.

Dấu tích xanh là thành công; đồng hồ cát nghĩa là chạy được nhưng mất hơn ba giây.
Dấu chữ thập đỏ nghĩa là yêu cầu thất bại. Lý do không hiện trên nút, nên hãy thử dịch một trang thật để xem nội dung lỗi.
Nút bị vô hiệu khi ô API key còn trống, trừ DeepLX vì nó được phép chạy mà không cần khóa.
Kết quả tự mất sau vài giây, và bị đặt lại ngay khi bạn sửa nhà cung cấp, khóa hay URL — nhờ vậy một dấu tích cũ không bao giờ đứng ra bảo chứng cho cấu hình mà bạn đã đổi từ lúc đó.

Khi nào nên chọn loại này

Hãy chọn một nhà cung cấp dịch thuần khi:

Bạn dịch những trang dài hoặc trọn cả một luồng phụ đề và muốn độ trễ mỗi yêu cầu thấp nhất.
Bạn muốn chi phí đoán được. DeepL tính theo ký tự chứ không theo token, và một khóa DeepL miễn phí hay một thực thể DeepLX công khai thì không tốn gì.
Hạn mức LLM của bạn eo hẹp và bạn muốn dành nó cho Hành động AI tùy chỉnh hơn là cho việc dịch trang hàng loạt.

Hãy ở lại với một nhà cung cấp LLM khi:

Bạn dựa vào bảng thuật ngữ, một câu lệnh cá nhân hóa hay Ngữ cảnh thông minh AI.
Văn bản cần sự phán đoán hơn là độ chính xác từng chữ — thành ngữ, câu đùa, thuật ngữ chuyên ngành.
Bạn muốn một nhà cung cấp lo cả việc dịch và các tính năng AI, thay vì phải giữ hai bộ cấu hình.

Một cách dung hòa tốt là cho dịch trang chạy trên nhà cung cấp dịch thuần và giữ thanh công cụ chọn ở một LLM, để đường đi thường xuyên thì rẻ mà đường đi kỹ lưỡng vẫn còn đó cho những từ bạn dừng lại xem.

Khắc phục sự cố

"DeepL API key is not configured"

Ô API Key đang trống. DeepL không có chế độ chạy mà không cần khóa.

"DeepL translation request failed" hoặc "DeepLX translation request failed"

Nhà cung cấp trả về một trạng thái lỗi. Read Frog nối mã trạng thái và phần nội dung lỗi của chính nhà cung cấp vào sau thông báo này, và đó thường là thứ đáng đọc trước nhất. Nguyên nhân thường gặp là khóa không hợp lệ hoặc đã hết hạn, khóa không khớp với gói, và hạn mức ký tự đã cạn.

"API key is required when using `{{apiKey}}` placeholder in DeepLX baseURL"

Base URL của bạn có chỗ giữ vị trí nhưng ô API Key lại trống. Hãy điền khóa vào, hoặc bỏ chỗ giữ vị trí khỏi URL.

"Unexpected response format from DeepLX translation API"

Yêu cầu thành công nhưng nội dung trả về không phải thứ một thực thể DeepLX trả ra. Read Frog trông đợi một JSON có bản dịch nằm trong trường chuỗi data. Những thực thể công khai đã bị chuyển sang mục đích khác hoặc bị đặt sau một trang đăng nhập thường thất bại ở đây.