Read Frog
Nhà cung cấp mô hình

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.

Cài đặt trên ChromeHơn 60 N người dùng Chrome đang sử dụngCác trình duyệt khácFirefoxEdge

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ụ:

  1. Token trong đường dẫn: https://api.deeplx.com/{{apiKey}}/translate
  2. Token dưới dạng tham số truy vấn: https://api.deeplx.com/v1/translate?token={{apiKey}}
  3. 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/translate

Token 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/translate

Token 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-key

Endpoint 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/translate

Thiết lập DeepLX trong Read Frog

  1. 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
  2. Vào mục Nhà cung cấp API: Chuyển đến phần Nhà cung cấp API
  3. 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
  4. 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/translate
  • https://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:

  1. 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
  2. Kiểm tra vị trí token: Đảm bảo {{apiKey}} nằm đúng chỗ
  3. 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.

Nội dung trang