DeepLX
DeepLX là API dịch miễn phí, không chính thức, cho chất lượng gần với DeepL. Hướng dẫn kết nối DeepLX với Read Frog: định dạng baseURL, vị trí đặt API token và các endpoint không cần key.

Read Frog
Read Frog là tiện ích trình duyệt mã nguồn mở: dịch song ngữ trang web và video YouTube, X ngay cạnh bản gốc, rồi lưu từ và câu thành thẻ ghi nhớ để ôn tập. Hãy cài đặt trước, sau đó làm theo các bước bên dưới.
DeepLX là gì?
DeepLX là một API miễn phí, không chính thức, dùng kỹ thuật đảo ngược (reverse engineering) để mang lại chất lượng dịch gần với DeepL. Đây là lựa chọn thay thế DeepL API chính thức, dành cho các nhà phát triển cần dịch vụ dịch chất lượng cao mà không phải trả phí.
Cấu hình baseURL linh hoạt
Read Frog cho phép cấu hình baseURL của DeepLX một cách linh hoạt để dùng được với nhiều nhà cung cấp DeepLX khác nhau. Bạn có thể tùy chỉnh baseURL sao cho khớp với định dạng endpoint riêng của nhà cung cấp mình dùng.
Placeholder cho token
Bạn có thể đặt placeholder {{apiKey}} vào baseURL để chèn API token vào bất kỳ vị trí nào. Cách này hữu ích khi mỗi nhà cung cấp DeepLX lại yêu cầu đặt token vào URL theo một cách riêng.
Ví dụ:
- Token trong đường dẫn:
https://api.deeplx.com/{{apiKey}}/translate - Token dưới dạng tham số truy vấn:
https://api.deeplx.com/v1/translate?token={{apiKey}} - Token trong tên miền phụ:
https://{{apiKey}}.api.deeplx.com/translate
Base URL được dùng đúng như bạn nhập
Ngoài việc điền giá trị cho {{apiKey}}, Read Frog gửi yêu cầu tới Base URL đúng như bạn nhập: không tự thêm /translate, cũng không tự chèn token. Vì vậy, hãy nhập endpoint đầy đủ của nhà cung cấp, thường kết thúc bằng /translate. Giá trị mặc định là https://api.deeplx.org/{{apiKey}}/translate.
Nếu nhà cung cấp cần token, hãy đặt {{apiKey}} vào đúng vị trí của token. Trường API Key chỉ dùng để điền vào placeholder này.
Ví dụ cấu hình
Không cần API token
Một số nhà cung cấp DeepLX không yêu cầu xác thực:
BaseURL: https://deeplx.vercel.app/translate
API Key: (để trống)
Kết quả: https://deeplx.vercel.app/translateToken trong đường dẫn
BaseURL: https://api.deeplx.com/{{apiKey}}/translate
API Key: your-secret-token
Kết quả: https://api.deeplx.com/your-secret-token/translateToken dưới dạng tham số truy vấn
BaseURL: https://api.example.com/v1/translate?key={{apiKey}}
API Key: your-api-key
Kết quả: https://api.example.com/v1/translate?key=your-api-keyEndpoint tùy chỉnh có token
BaseURL: https://deeplx.mydomain.com/api/{{apiKey}}/translate
API Key: abc123
Kết quả: https://deeplx.mydomain.com/api/abc123/translateThiết lập DeepLX trong Read Frog
- Mở trang Tùy chọn của tiện ích: Nhấp vào biểu tượng tiện ích Read Frog, sau đó vào Tùy chọn
- Vào mục Nhà cung cấp API: Chuyển đến phần Nhà cung cấp API
- Cấu hình DeepLX:
- Nhập endpoint đầy đủ của nhà cung cấp vào Base URL, kể cả phần
/translate - Nếu nhà cung cấp cần token, hãy đặt
{{apiKey}}vào đúng vị trí trong Base URL và nhập token vào API Key - Để trống API Key nếu nhà cung cấp không yêu cầu
- Nhập endpoint đầy đủ của nhà cung cấp vào Base URL, kể cả phần
- Dịch thử: Thử dịch một đoạn văn bản để xác nhận cấu hình đã hoạt động
Một số nhà cung cấp DeepLX phổ biến
Nhà cung cấp miễn phí (không cần API key)
https://deeplx.vercel.app/translatehttps://deeplx.herokuapp.com/translate
Nhà cung cấp trả phí hoặc tự triển khai
https://api.deeplx.org/{{apiKey}}/translate(cần API key; đây là giá trị mặc định)- Máy chủ DeepLX do bạn tự triển khai
Khắc phục sự cố
Lỗi khi tạo URL
Nếu URL được tạo ra không đúng như mong muốn:
- Kiểm tra Base URL đã là endpoint đầy đủ chưa: Read Frog không tự thêm
/translate, nên Base URL phải có sẵn phần này - Kiểm tra vị trí token: Đảm bảo
{{apiKey}}nằm đúng chỗ - Thử không dùng token trước: Dùng thử một nhà cung cấp miễn phí để khoanh vùng lỗi cấu hình
Lỗi thường gặp
- "API key is required when using
{{apiKey}}placeholder": Bạn đã thêm{{apiKey}}vào baseURL nhưng chưa nhập API key - "DeepLX translation request failed": Kiểm tra lại xem baseURL và API key có đúng không
- Lỗi mạng: Kiểm tra xem nhà cung cấp DeepLX có truy cập được và đang hoạt động hay không
Định dạng phản hồi của API
Nhà cung cấp DeepLX cần trả về phản hồi JSON theo định dạng sau:
{
"data": "văn bản đã dịch"
}Nếu bạn tự triển khai DeepLX, hãy đảm bảo máy chủ trả về phản hồi đúng định dạng này.
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.
DeepL
Định cấu hình DeepL API chính thức trong Read Frog. Tìm hiểu cách tự động phát hiện khóa Free và Pro, những trường cần điền và cách khắc phục các lỗi phổ biến.