Blog

Cách sử dụng DeepL API miễn phí với DeepLX

Mark Ponomarev

Mark Ponomarev

21 tháng 5 2025

Cách sử dụng DeepL API miễn phí với DeepLX

Trong một thế giới ngày càng kết nối, nhu cầu về dịch vụ dịch thuật nhanh chóng, chính xác và dễ tiếp cận là vô cùng quan trọng. DeepL đã nổi lên như một công ty hàng đầu trong lĩnh vực này, nổi tiếng với các bản dịch sắc thái và tự nhiên nhờ công nghệ dịch máy thần kinh tiên tiến. Tuy nhiên, việc truy cập API chính thức của DeepL thường đi kèm với chi phí mà không phải tất cả người dùng, nhà phát triển hoặc các dự án quy mô nhỏ đều có thể chi trả. Đây là lúc DeepLX xuất hiện, một dự án mã nguồn mở của OwO-Network cung cấp một giải pháp thay thế miễn phí để tận dụng khả năng dịch thuật mạnh mẽ của DeepL.

Hướng dẫn toàn diện này sẽ đi sâu vào DeepLX là gì, lợi ích của nó, cách cài đặt và sử dụng, những cân nhắc quan trọng liên quan đến tính không chính thức của nó, và cách nó so sánh với các dịch vụ chính thức. Cho dù bạn là nhà phát triển muốn tích hợp dịch thuật vào ứng dụng của mình, người yêu thích thử nghiệm các công cụ ngôn ngữ, hay chỉ đơn giản là tìm kiếm các giải pháp dịch thuật hiệu quả về chi phí, việc hiểu về DeepLX có thể mở ra những khả năng mới.

💡
Bạn muốn một công cụ Kiểm thử API tuyệt vời có thể tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng Tích hợp, Tất cả trong Một cho Đội ngũ Nhà phát triển của bạn để làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!
button

DeepLX là gì? Lời hứa về dịch thuật miễn phí, chất lượng cao

Về cốt lõi, DeepL là một công ty AI của Đức cung cấp dịch vụ dịch máy nổi tiếng về độ chính xác vượt trội và khả năng nắm bắt ngữ cảnh cũng như sắc thái ngôn ngữ, thường vượt trội hơn các đối thủ cạnh tranh đối với nhiều cặp ngôn ngữ. Để cho phép truy cập lập trình vào công cụ dịch của mình, DeepL cung cấp một API chính thức, đây là dịch vụ trả phí với các gói khác nhau phục vụ các khối lượng sử dụng khác nhau.

DeepLX, được tìm thấy trên GitHub dưới OwO-Network, tự giới thiệu là "API dịch thuật DeepL mạnh mẽ" với các đặc điểm:

Về cơ bản, DeepLX hoạt động như một trung gian hoặc proxy, cho phép người dùng gửi yêu cầu dịch đến backend của DeepL mà không cần sử dụng trực tiếp API trả phí chính thức. Điều này thường đạt được bằng cách máy chủ DeepLX thực hiện các yêu cầu đến DeepL theo cách mô phỏng cách người dùng miễn phí truy cập dịch vụ (ví dụ: thông qua giao diện web hoặc ứng dụng desktop, mặc dù cơ chế chính xác có thể thay đổi và có thể bị DeepL thay đổi).

Điều quan trọng cần hiểu ngay từ đầu là DeepLX là một công cụ không chính thức. Nó không được DeepL SE phát triển hoặc xác nhận. Sự phân biệt này mang theo những ý nghĩa quan trọng liên quan đến độ tin cậy, tính ổn định và điều khoản dịch vụ, những điều này sẽ được thảo luận chi tiết sau. Đối tượng mục tiêu của DeepLX thường bao gồm các nhà phát triển cần truy cập API cho các dự án nhỏ hơn, các nhà nghiên cứu hoặc người dùng mà chi phí API chính thức của DeepL là quá cao.

Tại sao chọn DeepLX? Lợi ích và Ưu điểm

Mặc dù có trạng thái không chính thức, DeepLX mang lại một số lợi thế hấp dẫn thu hút người dùng:

Những lợi ích này làm cho DeepLX trở thành một lựa chọn hấp dẫn cho những ai cần sức mạnh dịch thuật của DeepL mà không phải chịu chi phí liên quan. Tuy nhiên, những lợi thế này phải được cân nhắc với những cân nhắc phát sinh từ phương pháp không chính thức của nó.

Trạng thái "Không chính thức": Những cân nhắc quan trọng và nhược điểm tiềm ẩn

Mặc dù "miễn phí" và "chất lượng cao" rất hấp dẫn, điều quan trọng là phải hiểu rõ "không chính thức" có nghĩa là gì trong ngữ cảnh của DeepLX:

Người dùng nên tiếp cận DeepLX một cách thận trọng, hiểu rằng nó có thể không phù hợp cho các ứng dụng quan trọng yêu cầu thời gian hoạt động được đảm bảo và hỗ trợ chính thức. Nó phù hợp nhất cho các trường hợp mà việc ngừng hoạt động không thường xuyên hoặc cần khắc phục sự cố là sự đánh đổi chấp nhận được cho việc truy cập miễn phí.

Bắt đầu: Cài đặt và Thiết lập DeepLX

Thiết lập DeepLX thường khá đơn giản, đặc biệt nếu bạn quen thuộc với Docker hoặc chạy các tệp nhị phân được biên dịch sẵn. Dưới đây là các phương pháp phổ biến:

Điều kiện tiên quyết

Phương pháp 1: Sử dụng Docker (Khuyến nghị để đơn giản)

Docker thường là cách dễ nhất để chạy DeepLX, vì nó đóng gói tất cả các phụ thuộc và cấu hình.

  1. Tìm ảnh Docker: OwO-Network hoặc các nhà phát triển đóng góp cho DeepLX thường cung cấp ảnh Docker trên Docker Hub. Bạn có thể tìm kiếm deeplx trên Docker Hub hoặc tìm hướng dẫn trên kho lưu trữ GitHub chính thức của DeepLX. Các ảnh phổ biến có thể được đặt tên như owonetwork/deeplx hoặc tương tự.
  2. Kéo ảnh: Mở terminal của bạn và chạy:
docker pull <tên_ảnh>:<thẻ>

(Thay thế <tên_ảnh>:<thẻ> bằng tên ảnh thực tế).

  1. Chạy container Docker:
docker run -d -p 1188:1188 --name my-deeplx <tên_ảnh>:<thẻ>
  1. Xác minh: Bạn có thể kiểm tra xem container có đang chạy hay không bằng lệnh docker ps. Dịch vụ DeepLX giờ đây sẽ có thể truy cập tại http://localhost:1188.

Phương pháp 2: Tải xuống các tệp nhị phân được biên dịch sẵn

Nhiều dự án mã nguồn mở cung cấp các tệp thực thi được biên dịch sẵn cho các hệ điều hành khác nhau.

  1. Truy cập GitHub Releases: Điều hướng đến kho lưu trữ GitHub chính thức của DeepLX (OwO-Network/DeepLX) và tìm phần "Releases".
  2. Tải xuống tệp nhị phân chính xác: Bạn sẽ tìm thấy các tệp nhị phân cho các hệ điều hành và kiến trúc khác nhau (ví dụ: deeplx_windows_amd64.exe, deeplx_linux_amd64, deeplx_darwin_amd64). Tải xuống tệp phù hợp với hệ thống của bạn.
  3. Cấp quyền thực thi (Linux/macOS):
chmod +x /đường/dẫn/đến/tệp_nhị_phân_deeplx_của_bạn
  1. Chạy tệp nhị phân:
./đường/dẫn/đến/tệp_nhị_phân_deeplx_của_bạn [tùy_chọn]

Tệp nhị phân có thể hỗ trợ các cờ dòng lệnh để cấu hình (ví dụ: chỉ định cổng bằng -p <số_cổng> hoặc mã thông báo để bảo mật phiên bản DeepLX, mặc dù điều này khác với khóa API của DeepL). Tham khảo tài liệu của dự án để biết các tùy chọn có sẵn.

  1. Tường lửa: Đảm bảo tường lửa hệ thống của bạn cho phép kết nối đến trên cổng mà DeepLX đang lắng nghe (mặc định 1188) nếu bạn có ý định truy cập nó từ các thiết bị khác trên mạng của mình.

Phương pháp 3: Biên dịch từ mã nguồn (Dành cho người dùng nâng cao)

Nếu bạn thích tự biên dịch hoặc muốn các thay đổi mới nhất chưa được phát hành:

  1. Cài đặt các phụ thuộc biên dịch: DeepLX thường được viết bằng các ngôn ngữ như Go hoặc Rust. Bạn sẽ cần cài đặt trình biên dịch và bộ công cụ tương ứng (ví dụ: môi trường ngôn ngữ lập trình Go). Kiểm tra kho lưu trữ GitHub để biết hướng dẫn biên dịch.
  2. Clone kho lưu trữ:
git clone [https://github.com/OwO-Network/DeepLX.git](https://github.com/OwO-Network/DeepLX.git)
cd DeepLX
  1. Biên dịch dự án: Thực hiện theo các lệnh biên dịch được chỉ định trong tệp README.md hoặc các script biên dịch của kho lưu trữ (ví dụ: go build . hoặc cargo build --release).
  2. Chạy tệp nhị phân đã biên dịch: Tệp thực thi thu được sau đó có thể được chạy như mô tả trong Phương pháp 2.

Cấu hình ban đầu (Phía máy chủ)

Bản thân DeepLX thường được thiết kế để chạy với cấu hình tối thiểu. Điều chính cần lưu ý là cổng mà nó lắng nghe (mặc định 1188). Một số phiên bản hoặc bản fork có thể cho phép đặt mã thông báo truy cập thông qua các đối số dòng lệnh hoặc biến môi trường (ví dụ: -token YOUR_SECRET_TOKEN). Mã thông báo này sau đó sẽ cần được cung cấp bởi các client để sử dụng phiên bản DeepLX của bạn, thêm một lớp bảo mật nếu điểm cuối DeepLX của bạn bị lộ ra ngoài.

Sau khi chạy, phiên bản DeepLX của bạn sẽ sẵn sàng nhận các yêu cầu dịch.

Cách sử dụng DeepLX: Thực hiện các yêu cầu dịch

Sau khi phiên bản DeepLX của bạn đã chạy (ví dụ: tại http://localhost:1188), bạn có thể bắt đầu gửi các yêu cầu dịch đến điểm cuối API của nó, thường là /translate.

Điểm cuối API

http://<máy_chủ_hoặc_ip_deeplx_của_bạn>:<cổng>/translate
(ví dụ: http://localhost:1188/translate nếu chạy cục bộ trên cổng mặc định)

Cấu trúc cuộc gọi API cơ bản

Các tham số chính trong nội dung JSON

Ví dụ sử dụng curl

Để dịch "Hello, world!" từ tiếng Anh sang tiếng Đức:

curl -X POST http://localhost:1188/translate \
     -H "Content-Type: application/json" \
     -d '{
           "text": "Hello, world!",
           "source_lang": "EN",
           "target_lang": "DE"
         }'

Giải thích phản hồi

Phản hồi thành công (ví dụ: HTTP 200 OK): Phản hồi sẽ là một đối tượng JSON thường chứa:

Ví dụ cấu trúc phản hồi thành công:JSON

{
    "code": 200,
    "id": 1678886400000,
    "data": "Hallo, Welt!",
    "source_lang": "EN",
    "target_lang": "DE",
    "alternatives": [
        "Hallo Welt!"
    ]
}

Phản hồi lỗi:

Sử dụng DeepLX với các ngôn ngữ lập trình (Ví dụ minh họa)

Python (sử dụng thư viện requests):Python

import requests
import json

deeplx_url = "http://localhost:1188/translate"
text_to_translate = "The quick brown fox jumps over the lazy dog."

payload = {
    "text": text_to_translate,
    "source_lang": "EN",
    "target_lang": "ES"  # Dịch sang tiếng Tây Ban Nha
}

headers = {
    "Content-Type": "application/json"
}

try:
    response = requests.post(deeplx_url, data=json.dumps(payload), headers=headers)
    response.raise_for_status()  # Gây ra ngoại lệ cho các mã trạng thái xấu (4xx hoặc 5xx)
    
    translation_data = response.json()
    
    if translation_data.get("code") == 200:
        print(f"Original: {text_to_translate}")
        print(f"Translated: {translation_data.get('data')}")
    else:
        print(f"Error from DeepLX: {translation_data.get('message', 'Unknown error')}")

except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")
except json.JSONDecodeError:
    print("Failed to decode JSON response.")

JavaScript (sử dụng API Workspace trong trình duyệt hoặc môi trường Node.js):JavaScript

async function translateText(text, targetLang, sourceLang = "auto") {
    const deeplxUrl = "http://localhost:1188/translate"; // Điều chỉnh nếu DeepLX của bạn ở nơi khác
    const payload = {
        text: text,
        source_lang: sourceLang,
        target_lang: targetLang
    };

    try {
        const response = await fetch(deeplxUrl, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(payload)
        });

        if (!response.ok) {
            // Cố gắng lấy thông báo lỗi từ DeepLX nếu có thể
            let errorMsg = `Lỗi HTTP! trạng thái: ${response.status}`;
            try {
                const errorData = await response.json();
                errorMsg = errorData.message || JSON.stringify(errorData);
            } catch (e) { /* bỏ qua nếu phản hồi không phải json */ }
            throw new Error(errorMsg);
        }

        const translationData = await response.json();

        if (translationData.code === 200) {
            return translationData.data;
        } else {
            throw new Error(translationData.message || `Mã lỗi API DeepLX: ${translationData.code}`);
        }
    } catch (error) {
        console.error("Dịch thất bại:", error);
        return null;
    }
}

// Ví dụ sử dụng:
(async () => {
    const translatedText = await translateText("Welcome to the world of AI.", "JA"); // Sang tiếng Nhật
    if (translatedText) {
        console.log(`Đã dịch: ${translatedText}`);
    }
})();

Hãy nhớ điều chỉnh deeplx_url nếu phiên bản DeepLX của bạn không chạy trên localhost:1188.

Tích hợp DeepLX với các ứng dụng

Một trong những trường hợp sử dụng chính của DeepLX là cung cấp năng lượng cho các tính năng dịch thuật trong các ứng dụng khác mà không phải chịu chi phí API chính thức. Một số công cụ và dự án đã chứng minh khả năng tích hợp:

Cách tiếp cận chung để tích hợp

  1. Thiết lập phiên bản DeepLX của bạn: Đảm bảo máy chủ DeepLX của bạn đang chạy và có thể truy cập được từ ứng dụng sẽ sử dụng nó.
  2. Xác định cài đặt cấu hình: Trong ứng dụng bạn muốn tích hợp, tìm các cài đặt liên quan đến dịch vụ dịch thuật hoặc DeepL API.
  3. Trỏ đến điểm cuối DeepLX của bạn: Thay vì URL API chính thức của DeepL (như https://api-free.deepl.com/v2/translate hoặc https://api.deepl.com/v2/translate), bạn thường sẽ nhập địa chỉ máy chủ DeepLX của mình (ví dụ: http://localhost:1188/translate hoặc http://ip-may-chu-cua-ban:1188/translate).
  4. Xử lý khóa API:
  1. Kiểm tra kỹ lưỡng: Sau khi cấu hình, kiểm tra chức năng dịch thuật trong ứng dụng để đảm bảo nó hoạt động chính xác với backend DeepLX của bạn.

Mức độ dễ dàng tích hợp phần lớn phụ thuộc vào tính linh hoạt của cấu hình dịch vụ dịch thuật của ứng dụng mục tiêu.

Những cân nhắc nâng cao và các thực hành tốt nhất

Để tận dụng tối đa DeepLX và giảm thiểu một số vấn đề tiềm ẩn của nó, hãy xem xét những điều sau:

Bằng cách chủ động, bạn có thể cải thiện tính ổn định và tiện ích của thiết lập DeepLX của mình.

Khắc phục sự cố DeepLX thường gặp

Gặp phải các vấn đề là điều có thể xảy ra do bản chất của DeepLX. Dưới đây là một số vấn đề phổ biến và cách tiếp cận chúng:

Vấn đề: Lỗi 429 Too Many Requests

Vấn đề: Phiên bản DeepLX không khởi động hoặc bị lỗi

Vấn đề: Bản dịch không chính xác, thất bại hoặc trả về kết quả không mong muốn

Vấn đề: Lỗi kết nối mạng (ví dụ: "Connection refused", "Timeout")

Khắc phục sự cố DeepLX thường liên quan đến việc kiểm tra nhật ký, xác minh cấu hình và theo dõi các cuộc thảo luận cộng đồng xung quanh dự án.

DeepLX so với API chính thức của DeepL: So sánh nhanh

Tính năngDeepLX (qua OwO-Network)API chính thức của DeepL (Gói miễn phí)API chính thức của DeepL (Gói Pro/Trả phí)
Chi phíMiễn phíMiễn phíTrả phí (đăng ký/theo ký tự)
NguồnKhông chính thức, mã nguồn mởChính thứcChính thức
Tính ổn địnhCó khả năng không ổn định, có thể bị hỏngThường ổn địnhĐộ ổn định cao, có thể có SLA
Giới hạn tốc độDễ gặp lỗi 429, ít dự đoán đượcGiới hạn 500.000 ký tự/thángGiới hạn cao hơn/có thể tùy chỉnh, trả theo mức sử dụng

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống