Blog

Cara Menggunakan DeepL API Gratis dengan DeepLX

Mark Ponomarev

Mark Ponomarev

21 May 2025

Cara Menggunakan DeepL API Gratis dengan DeepLX

Di dunia yang semakin terhubung, kebutuhan akan layanan terjemahan yang cepat, akurat, dan mudah diakses sangatlah penting. DeepL telah muncul sebagai pemimpin di bidang ini, terkenal karena terjemahannya yang bernuansa dan terdengar alami yang didukung oleh terjemahan mesin saraf tingkat lanjut. Namun, mengakses API resminya sering kali memerlukan biaya yang mungkin tidak terjangkau untuk semua pengguna, pengembang, atau proyek skala kecil. Hadirlah DeepLX, proyek sumber terbuka oleh OwO-Network yang menawarkan jalur alternatif gratis untuk memanfaatkan kemampuan terjemahan DeepL yang kuat.

Panduan komprehensif ini akan membahas apa itu DeepLX, manfaatnya, cara menginstal dan menggunakannya, pertimbangan penting terkait sifatnya yang tidak resmi, dan bagaimana perbandingannya dengan penawaran resmi. Baik Anda seorang pengembang yang ingin mengintegrasikan terjemahan ke dalam aplikasi Anda, seorang penghobi yang bereksperimen dengan alat bahasa, atau sekadar mencari solusi terjemahan yang hemat biaya, memahami DeepLX dapat membuka kemungkinan baru.

💡
Ingin alat Pengujian API hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform All-in-One yang terintegrasi untuk Tim Pengembang Anda bekerja sama dengan produktivitas maksimum?

Apidog memenuhi semua kebutuhan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!
button

Apa itu DeepLX? Janji Terjemahan Berkualitas Tinggi Gratis

Pada intinya, DeepL adalah perusahaan AI asal Jerman yang menyediakan layanan terjemahan mesin yang dikenal karena akurasi luar biasa dan kemampuannya menangkap konteks dan nuansa linguistik, sering kali mengungguli pesaing untuk banyak pasangan bahasa. Untuk memungkinkan akses terprogram ke mesin terjemahannya, DeepL menawarkan API resmi, yang merupakan layanan berbayar dengan berbagai tingkatan yang melayani volume penggunaan yang berbeda.

DeepLX, yang ditemukan di GitHub di bawah OwO-Network, menampilkan dirinya sebagai "API Terjemahan DeepL yang Kuat" yang bersifat:

Pada dasarnya, DeepLX bertindak sebagai perantara atau proksi, memungkinkan pengguna mengirim permintaan terjemahan ke backend DeepL tanpa menggunakan API berbayar resmi secara langsung. Ini biasanya dicapai oleh server DeepLX yang membuat permintaan ke DeepL dengan cara yang meniru bagaimana pengguna gratis dapat mengakses layanan (misalnya, melalui antarmuka web atau aplikasi desktopnya, meskipun mekanisme pastinya dapat bervariasi dan dapat berubah).

Sangat penting untuk dipahami sejak awal bahwa DeepLX adalah alat tidak resmi. Ini tidak dikembangkan atau didukung oleh DeepL SE. Perbedaan ini membawa implikasi penting terkait keandalan, stabilitas, dan ketentuan layanan, yang akan dibahas secara rinci nanti. Target audiens untuk DeepLX umumnya mencakup pengembang yang membutuhkan akses API untuk proyek yang lebih kecil, peneliti, atau pengguna yang biaya API DeepL resmi terlalu mahal.

Mengapa Memilih DeepLX? Manfaat dan Keuntungan

Meskipun statusnya tidak resmi, DeepLX menawarkan beberapa keuntungan menarik yang menarik pengguna:

Manfaat-manfaat ini menjadikan DeepLX proposisi yang menarik bagi mereka yang membutuhkan kehebatan terjemahan DeepL tanpa biaya terkait. Namun, keuntungan ini harus diimbangi dengan pertimbangan yang berasal dari pendekatan tidak resminya.

Status "Tidak Resmi": Pertimbangan Kritis dan Potensi Kelemahan

Meskipun "gratis" dan "berkualitas tinggi" menarik, penting untuk memiliki pemahaman yang jelas tentang apa arti "tidak resmi" dalam konteks DeepLX:

Pengguna harus mendekati DeepLX dengan hati-hati, memahami bahwa itu mungkin tidak cocok untuk aplikasi misi-kritis di mana waktu aktif yang terjamin dan dukungan resmi diperlukan. Ini paling baik untuk skenario di mana waktu henti sesekali atau kebutuhan akan pemecahan masalah dapat diterima sebagai imbalan untuk penghematan biaya.

Memulai: Instalasi dan Pengaturan DeepLX

Mengatur DeepLX umumnya mudah, terutama jika Anda terbiasa dengan Docker atau menjalankan biner yang sudah dikompilasi. Berikut adalah metode umum:

Prasyarat

Metode 1: Menggunakan Docker (Direkomendasikan untuk Kemudahan)

Docker seringkali merupakan cara termudah untuk menjalankan DeepLX, karena mengemas semua dependensi dan konfigurasi.

  1. Temukan Image Docker: OwO-Network atau pengembang yang berkontribusi pada DeepLX biasanya menyediakan image Docker di Docker Hub. Anda dapat mencari deeplx di Docker Hub atau mencari instruksi di repositori GitHub resmi DeepLX. Image umum mungkin diberi nama seperti owonetwork/deeplx atau yang serupa.
  2. Pull Image: Buka terminal Anda dan jalankan:
docker pull <nama_image>:<tag>

(Ganti <nama_image>:<tag> dengan nama image yang sebenarnya).

  1. Jalankan Kontainer Docker:
docker run -d -p 1188:1188 --name my-deeplx <nama_image>:<tag>
  1. Verifikasi: Anda dapat memeriksa apakah kontainer sedang berjalan dengan docker ps. Layanan DeepLX sekarang seharusnya dapat diakses di http://localhost:1188.

Metode 2: Mengunduh Biner yang Sudah Dikompilasi

Banyak proyek sumber terbuka menyediakan executable yang sudah dikompilasi untuk berbagai sistem operasi.

  1. Buka Rilis GitHub: Navigasi ke repositori GitHub resmi DeepLX (OwO-Network/DeepLX) dan cari bagian "Releases".
  2. Unduh Biner yang Benar: Anda akan menemukan biner untuk berbagai sistem operasi dan arsitektur (misalnya, deeplx_windows_amd64.exe, deeplx_linux_amd64, deeplx_darwin_amd64). Unduh yang sesuai dengan sistem Anda.
  3. Jadikan Dapat Dieksekusi (Linux/macOS):
chmod +x /path/to/your/deeplx_binary
  1. Jalankan Biner:
./path/to/your/deeplx_binary [opsi]

Biner mungkin mendukung flag baris perintah untuk konfigurasi (misalnya, menentukan port dengan -p <nomor_port> atau token untuk mengamankan instance DeepLX itu sendiri, meskipun ini berbeda dari kunci API DeepL). Lihat dokumentasi proyek untuk opsi yang tersedia.

  1. Firewall: Pastikan firewall sistem Anda mengizinkan koneksi masuk pada port tempat DeepLX mendengarkan (default 1188) jika Anda berniat mengaksesnya dari perangkat lain di jaringan Anda.

Metode 3: Membangun dari Sumber (Untuk Pengguna Tingkat Lanjut)

Jika Anda lebih suka mengkompilasinya sendiri atau ingin perubahan terbaru yang belum dirilis:

  1. Instal Dependensi Build: DeepLX sering ditulis dalam bahasa seperti Go atau Rust. Anda akan memerlukan kompiler dan toolchain yang sesuai terinstal (misalnya, lingkungan bahasa pemrograman Go). Periksa repositori GitHub untuk instruksi build.
  2. Klon Repositori:
git clone [https://github.com/OwO-Network/DeepLX.git](https://github.com/OwO-Network/DeepLX.git)
cd DeepLX
  1. Bangun Proyek: Ikuti perintah build yang ditentukan dalam README.md repositori atau skrip build (misalnya, go build . atau cargo build --release).
  2. Jalankan Biner yang Dikompilasi: Executable yang dihasilkan kemudian dapat dijalankan seperti yang dijelaskan dalam Metode 2.

Konfigurasi Awal (Sisi Server)

DeepLX itu sendiri sering dirancang untuk berjalan dengan konfigurasi minimal. Hal utama yang perlu diperhatikan adalah port tempat ia mendengarkan (default 1188). Beberapa versi atau fork mungkin memungkinkan pengaturan token akses melalui argumen baris perintah atau variabel lingkungan (misalnya, -token YOUR_SECRET_TOKEN). Token ini kemudian perlu disediakan oleh klien untuk menggunakan instance DeepLX Anda, menambahkan lapisan keamanan jika titik akhir DeepLX Anda terekspos.

Setelah berjalan, instance DeepLX Anda seharusnya siap menerima permintaan terjemahan.

Cara Menggunakan DeepLX: Membuat Permintaan Terjemahan

Setelah instance DeepLX Anda aktif dan berjalan (misalnya, di http://localhost:1188), Anda dapat mulai mengirim permintaan terjemahan ke titik akhir API-nya, yang biasanya /translate.

Titik Akhir API

http://<host_atau_ip_deeplx_anda>:<port>/translate
(misalnya, http://localhost:1188/translate jika berjalan secara lokal di port default)

Struktur Panggilan API Dasar

Parameter Kunci dalam Body JSON

Contoh menggunakan curl

Untuk menerjemahkan "Hello, world!" dari bahasa Inggris ke bahasa Jerman:

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

Menginterpretasikan Respons

Respons Berhasil (misalnya, HTTP 200 OK): Respons akan berupa objek JSON yang biasanya berisi:

Contoh struktur respons berhasil:JSON

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

Respons Kesalahan:

Menggunakan DeepLX dengan Bahasa Pemrograman (Contoh Konseptual)

Python (menggunakan library 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"  # Terjemahkan ke Bahasa Spanyol
}

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

try:
    response = requests.post(deeplx_url, data=json.dumps(payload), headers=headers)
    response.raise_for_status()  # Angkat pengecualian untuk kode status buruk (4xx atau 5xx)
    
    translation_data = response.json()
    
    if translation_data.get("code") == 200:
        print(f"Original: {text_to_translate}")
        print(f"Diterjemahkan: {translation_data.get('data')}")
    else:
        print(f"Kesalahan dari DeepLX: {translation_data.get('message', 'Kesalahan tidak diketahui')}")

except requests.exceptions.RequestException as e:
    print(f"Permintaan gagal: {e}")
except json.JSONDecodeError:
    print("Gagal mendekode respons JSON.")

JavaScript (menggunakan API Workspace di browser atau lingkungan Node.js):JavaScript

async function translateText(text, targetLang, sourceLang = "auto") {
    const deeplxUrl = "http://localhost:1188/translate"; // Sesuaikan jika DeepLX Anda di tempat lain
    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) {
            // Coba dapatkan pesan kesalahan dari DeepLX jika memungkinkan
            let errorMsg = `Kesalahan HTTP! status: ${response.status}`;
            try {
                const errorData = await response.json();
                errorMsg = errorData.message || JSON.stringify(errorData);
            } catch (e) { /* abaikan jika respons bukan json */ }
            throw new Error(errorMsg);
        }

        const translationData = await response.json();

        if (translationData.code === 200) {
            return translationData.data;
        } else {
            throw new Error(translationData.message || `Kode kesalahan API DeepLX: ${translationData.code}`);
        }
    } catch (error) {
        console.error("Terjemahan gagal:", error);
        return null;
    }
}

// Contoh penggunaan:
(async () => {
    const translatedText = await translateText("Welcome to the world of AI.", "JA"); // Ke Bahasa Jepang
    if (translatedText) {
        console.log(`Diterjemahkan: ${translatedText}`);
    }
})();

Ingatlah untuk menyesuaikan deeplx_url jika instance DeepLX Anda tidak berjalan di localhost:1188.

Mengintegrasikan DeepLX dengan Aplikasi

Salah satu kasus penggunaan utama untuk DeepLX adalah untuk mendukung fitur terjemahan dalam aplikasi lain tanpa menimbulkan biaya API resmi. Beberapa alat dan proyek telah menunjukkan integrasi:

Pendekatan Umum untuk Integrasi

  1. Siapkan Instance DeepLX Anda: Pastikan server DeepLX Anda berjalan dan dapat diakses dari aplikasi yang akan menggunakannya.
  2. Identifikasi Pengaturan Konfigurasi: Di aplikasi yang ingin Anda integrasikan, cari pengaturan terkait layanan terjemahan atau DeepL API.
  3. Arahkan ke Titik Akhir DeepLX Anda: Alih-alih URL API DeepL resmi (seperti https://api-free.deepl.com/v2/translate atau https://api.deepl.com/v2/translate), Anda biasanya akan memasukkan alamat server DeepLX Anda (misalnya, http://localhost:1188/translate atau http://ip-server-anda:1188/translate).
  4. Penanganan Kunci API:
  1. Uji Secara Menyeluruh: Setelah konfigurasi, uji fungsionalitas terjemahan dalam aplikasi untuk memastikan ia bekerja dengan benar dengan backend DeepLX Anda.

Kemudahan integrasi sangat bergantung pada seberapa fleksibel konfigurasi layanan terjemahan aplikasi target.

Pertimbangan Lanjutan dan Praktik Terbaik

Untuk memanfaatkan DeepLX secara maksimal dan mengurangi beberapa potensi masalahnya, pertimbangkan hal berikut:

Dengan bersikap proaktif, Anda dapat meningkatkan stabilitas dan kegunaan pengaturan DeepLX Anda.

Memecahkan Masalah Umum DeepLX

Mengalami masalah mungkin terjadi mengingat sifat DeepLX. Berikut adalah beberapa masalah umum dan cara mengatasinya:

Masalah: Kesalahan 429 Too Many Requests

Masalah: Instance DeepLX Tidak Memulai atau Crash

Masalah: Terjemahan Tidak Akurat, Gagal, atau Mengembalikan Hasil yang Tidak Terduga

Masalah: Kesalahan Koneksi Jaringan (misalnya, "Connection refused," "Timeout")

Pemecahan masalah DeepLX sering kali melibatkan pemeriksaan log, verifikasi konfigurasi, dan mengawasi diskusi komunitas seputar proyek.

DeepLX vs. API DeepL Resmi: Perbandingan Singkat

FiturDeepLX (via OwO-Network)API DeepL Resmi (Tingkat Gratis)API DeepL Resmi (Pro/Berbayar)
BiayaGratisGratisBerbayar (langganan/per-karakter)
SumberTidak resmi, sumber terbukaResmiResmi
StabilitasBerpotensi tidak stabil, dapat rusakUmumnya stabilStabilitas tinggi, SLA mungkin ditawarkan
Pembatasan LajuRentan terhadap kesalahan 429, kurang dapat diprediksiBatas 500.000 karakter/bulanBatas lebih tinggi/dapat disesuaikan, bayar sesuai pemakaian
Set FiturTerutama terjemahan, fitur terbatasTerjemahan dasar, fitur terbatasSet fitur lengkap (glosarium, dll.)

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.

Daftar gratisUnduh