Blog
Bakış Açısı

DeepLX ile Ücretsiz DeepL API'si Nasıl Kullanılır

Artan bağlantılı dünyada hızlı, doğru ve erişilebilir çeviri hizmetleri şart. DeepL, gelişmiş sinirsel makine çevirisiyle öne çıkıyor. DeepLX, ücretsiz bir alternatif sunuyor.

Efe Demir

Efe Demir

5 June 2025

DeepLX ile Ücretsiz DeepL API'si Nasıl Kullanılır

Giderek birbirine bağlı bir dünyada, hızlı, doğru ve erişilebilir çeviri hizmetlerine duyulan ihtiyaç çok önemlidir. DeepL, gelişmiş sinirsel makine çevirisiyle desteklenen nüanslı ve doğal sesli çevirileriyle tanınan, bu alanda lider olarak ortaya çıktı. Ancak, resmi API'sine erişmek genellikle tüm kullanıcılar, geliştiriciler veya küçük ölçekli projeler için uygun olmayabilecek maliyetlerle gelir. DeepLX'e girin, DeepL'in güçlü çeviri yeteneklerinden yararlanmak için ücretsiz bir alternatif yol sunan OwO-Network tarafından geliştirilen açık kaynaklı bir proje.

Bu kapsamlı kılavuz, DeepLX'in ne olduğu, faydaları, nasıl kurulup kullanılacağı, resmi olmayan doğasıyla ilgili önemli hususlar ve resmi tekliflere karşı nasıl durduğu konularına değinecektir. Uygulamalarınıza çeviri entegre etmek isteyen bir geliştirici, dil araçlarıyla denemeler yapan bir hobi sahibi veya sadece uygun maliyetli çeviri çözümleri arayan biri olun, DeepLX'i anlamak yeni olanakların kilidini açabilir.

💡
Harika API Dokümantasyonu oluşturan harika bir API Test aracı mı istiyorsunuz?

Maksimum verimlilikle birlikte çalışmak için Geliştirici Ekibiniz için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?

Apidog tüm taleplerinizi karşılıyor ve Postman'in yerini çok daha uygun bir fiyata alıyor!
button

DeepLX Nedir? Ücretsiz, Yüksek Kaliteli Çevirinin Vaadi

Temelinde, DeepL, birçok dil çifti için genellikle rakiplerinden daha iyi performans gösteren, olağanüstü doğruluğu ve bağlamı ve dilsel nüansları yakalama yeteneği ile bilinen makine çevirisi hizmetleri sağlayan bir Alman yapay zeka şirketidir. Çeviri motoruna programlı erişime izin vermek için DeepL, farklı kullanım hacimlerine hitap eden çeşitli katmanlara sahip, ücretli bir hizmet olan resmi bir API sunar.

OwO-Network altında GitHub'da bulunan DeepLX, kendisini şu şekilde tanıtır: "Güçlü DeepL Çeviri API" şunlardır:

Esasen DeepLX, kullanıcıların resmi ücretli API'yi doğrudan kullanmadan çeviri isteklerini DeepL'in arka ucuna göndermesine izin veren bir aracı veya proxy görevi görür. Bu genellikle DeepLX sunucusunun, ücretsiz bir kullanıcının hizmete nasıl erişebileceğini taklit ederek (örneğin, web arayüzü veya masaüstü uygulamaları aracılığıyla, ancak tam mekanizma değişebilir ve değişebilir) DeepL'e istek göndermesiyle sağlanır.

Başlangıçtan itibaren DeepLX'in resmi olmayan bir araç olduğunu anlamak çok önemlidir. DeepL SE tarafından geliştirilmemiştir veya desteklenmemiştir. Bu ayrım, daha sonra ayrıntılı olarak tartışılacak olan güvenilirlik, istikrar ve hizmet şartları ile ilgili önemli sonuçlar taşır. DeepLX için hedef kitle genellikle daha küçük projeler için API erişimine ihtiyaç duyan geliştiriciler, araştırmacılar veya resmi DeepL API maliyetlerinin engelleyici olduğu kullanıcıları içerir.

Neden DeepLX'i Seçmelisiniz? Faydaları ve Avantajları

Resmi olmayan statüsüne rağmen, DeepLX kullanıcıları çeken çeşitli cazip avantajlar sunar:

Bu faydalar, DeepL'in çeviri becerisine ilişkili maliyetler olmadan ihtiyaç duyanlar için cazip bir teklif haline getiriyor. Ancak, bu avantajlar, resmi olmayan yaklaşımından kaynaklanan hususlarla karşılaştırılmalıdır.

"Resmi Olmayan" Durum: Kritik Hususlar ve Potansiyel Dezavantajlar

"ücretsiz" ve "yüksek kaliteli" cazip olsa da, DeepLX bağlamında "resmi olmayan"ın ne anlama geldiğini net bir şekilde anlamak hayati öneme sahiptir:

Kullanıcılar, DeepLX'e bir miktar dikkatle yaklaşmalı, garantili çalışma süresi ve resmi desteğin gerekli olduğu görev açısından kritik uygulamalar için uygun olmayabileceğini anlamalıdır. Ara sıra kesinti veya sorun giderme ihtiyacının ücretsiz erişim için kabul edilebilir ödünleşimler olduğu senaryolar için en iyisidir.

Başlarken: DeepLX'in Kurulumu ve Ayarlanması

DeepLX'i kurmak genellikle basittir, özellikle Docker'a aşinaysanız veya önceden derlenmiş ikili dosyaları çalıştırıyorsanız. İşte yaygın yöntemler:

Önkoşullar

Yöntem 1: Docker Kullanma (Basitlik İçin Önerilir)

Docker, tüm bağımlılıkları ve yapılandırmaları paketlediği için DeepLX'i çalıştırmanın genellikle en kolay yoludur.

  1. Docker Görüntüsünü Bulun: DeepLX'e katkıda bulunan OwO-Network veya geliştiriciler genellikle Docker Hub'da Docker görüntüleri sağlar. Docker Hub'da deeplx arayabilir veya resmi DeepLX GitHub deposundaki talimatlara bakabilirsiniz. Yaygın görüntüler owonetwork/deeplx veya benzeri gibi adlandırılabilir.
  2. Görüntüyü Çekin: Terminalinizi açın ve şunu çalıştırın:
docker pull <image_name>:<tag>

(<image_name>:<tag> öğesini gerçek görüntü adıyla değiştirin).

  1. Docker Kapsayıcısını Çalıştırın:
docker run -d -p 1188:1188 --name my-deeplx <image_name>:<tag>
  1. Doğrulayın: Kapsayıcının çalışıp çalışmadığını docker ps ile kontrol edebilirsiniz. DeepLX hizmetine artık http://localhost:1188 adresinden erişilebilmelidir.

Yöntem 2: Önceden Derlenmiş İkili Dosyaları İndirme

Birçok açık kaynaklı proje, çeşitli işletim sistemleri için önceden derlenmiş yürütülebilir dosyalar sağlar.

  1. GitHub Sürümlerine Gidin: Resmi DeepLX GitHub deposuna (OwO-Network/DeepLX) gidin ve "Sürümler" bölümünü arayın.
  2. Doğru İkili Dosyayı İndirin: Farklı işletim sistemleri ve mimariler için ikili dosyalar bulacaksınız (örneğin, deeplx_windows_amd64.exe, deeplx_linux_amd64, deeplx_darwin_amd64). Sisteminizle eşleşeni indirin.
  3. Yürütülebilir Yapın (Linux/macOS):
chmod +x /path/to/your/deeplx_binary
  1. İkili Dosyayı Çalıştırın:
./path/to/your/deeplx_binary [options]

İkili dosya, yapılandırma için komut satırı bayraklarını destekleyebilir (örneğin, -p <port_number> ile bir bağlantı noktası belirtmek veya DeepLX örneğinin kendisini güvence altına almak için bir belirteç, ancak bu, bir DeepL API anahtarından farklıdır). Mevcut seçenekler için projenin belgelerine bakın.

  1. Güvenlik Duvarı: Ağınızdaki diğer cihazlardan erişmek istiyorsanız, sisteminizin güvenlik duvarının DeepLX'in dinlediği bağlantı noktasında (varsayılan 1188) gelen bağlantılara izin verdiğinden emin olun.

Yöntem 3: Kaynaktan Oluşturma (Gelişmiş Kullanıcılar İçin)

Kendiniz derlemeyi tercih ediyorsanız veya en son yayınlanmamış değişiklikleri istiyorsanız:

  1. Derleme Bağımlılıklarını Yükleyin: DeepLX genellikle Go veya Rust gibi dillerde yazılır. İlgili derleyici ve araç zincirinin yüklü olması gerekir (örneğin, Go programlama dili ortamı). Derleme talimatları için GitHub deposunu kontrol edin.
  2. Depoyu Klonlayın:
git clone [https://github.com/OwO-Network/DeepLX.git](https://github.com/OwO-Network/DeepLX.git)
cd DeepLX
  1. Projeyi Oluşturun: Deponun README.md veya derleme komut dosyalarında belirtilen derleme komutlarını izleyin (örneğin, go build . veya cargo build --release).
  2. Derlenmiş İkili Dosyayı Çalıştırın: Ortaya çıkan yürütülebilir dosya daha sonra Yöntem 2'de açıklandığı gibi çalıştırılabilir.

İlk Yapılandırma (Sunucu Tarafı)

DeepLX'in kendisi genellikle minimum yapılandırmayla çalışacak şekilde tasarlanmıştır. Dikkat edilmesi gereken birincil şey, dinlediği bağlantı noktasıdır (varsayılan 1188). Bazı sürümler veya çatallar, komut satırı argümanları veya ortam değişkenleri aracılığıyla bir erişim belirteci ayarlamaya izin verebilir (örneğin, -token YOUR_SECRET_TOKEN). Bu belirteç daha sonra, DeepLX uç noktanızın açığa çıkması durumunda bir güvenlik katmanı ekleyerek, DeepLX örneğinizi kullanmak için istemciler tarafından sağlanması gerekir.

Çalıştıktan sonra, DeepLX örneğiniz çeviri isteklerini almaya hazır olmalıdır.

DeepLX Nasıl Kullanılır: Çeviri İstekleri Yapma

DeepLX örneğiniz çalışır duruma geldikten sonra (örneğin, http://localhost:1188 adresinde), genellikle /translate olan API uç noktasına çeviri istekleri göndermeye başlayabilirsiniz.

API Uç Noktası

http://<your_deeplx_host_or_ip>:<port>/translate
(örneğin, yerel olarak varsayılan bağlantı noktasında çalışıyorsa http://localhost:1188/translate)

Temel API Çağrı Yapısı

JSON Gövdesindeki Temel Parametreler

curl kullanarak örnek

"Hello, world!" ifadesini İngilizce'den Almanca'ya çevirmek için:

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

Yanıtı Yorumlama

Başarılı Yanıt (örneğin, HTTP 200 OK): Yanıt, genellikle şunları içeren bir JSON nesnesi olacaktır:

Örnek başarılı yanıt yapısı:JSON

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

Hata Yanıtları:

DeepLX'i Programlama Dilleriyle Kullanma (Kavramsal Örnekler)

Python (requests kitaplığını kullanma):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"  # İspanyolca'ya çevir
}

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

try:
    response = requests.post(deeplx_url, data=json.dumps(payload), headers=headers)
    response.raise_for_status()  # Kötü durum kodları için bir istisna oluşturun (4xx veya 5xx)
    
    translation_data = response.json()
    
    if translation_data.get("code") == 200:
        print(f"Orijinal: {text_to_translate}")
        print(f"Çevrilmiş: {translation_data.get('data')}")
    else:
        print(f"DeepLX'ten hata: {translation_data.get('message', 'Bilinmeyen hata')}")

except requests.exceptions.RequestException as e:
    print(f"İstek başarısız oldu: {e}")
except json.JSONDecodeError:
    print("JSON yanıtı çözülemedi.")

JavaScript (bir tarayıcı veya Node.js ortamında Workspace API'sini kullanma):JavaScript

async function translateText(text, targetLang, sourceLang = "auto") {
    const deeplxUrl = "http://localhost:1188/translate"; // DeepLX'iniz başka bir yerde ise ayarlayın
    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) {
            // Mümkünse DeepLX'ten hata mesajı almaya çalışın
            let errorMsg = `HTTP hatası! durum: ${response.status}`;
            try {
                const errorData = await response.json();
                errorMsg = errorData.message || JSON.stringify(errorData);
            } catch (e) { /* yanıt json değilse yoksay */ }
            throw new Error(errorMsg);
        }

        const translationData = await response.json();

        if (translationData.code === 200) {
            return translationData.data;
        } else {
            throw new Error(translationData.message || `DeepLX API hata kodu: ${translationData.code}`);
        }
    } catch (error) {
        console.error("Çeviri başarısız oldu:", error);
        return null;
    }
}

// Örnek kullanım:
(async () => {
    const translatedText = await translateText("Welcome to the world of AI.", "JA"); // Japonca'ya
    if (translatedText) {
        console.log(`Çevrilmiş: ${translatedText}`);
    }
})();

DeepLX örneğiniz localhost:1188 üzerinde çalışmıyorsa, deeplx_url öğesini uyarlamayı unutmayın.

DeepLX'i Uygulamalarla Entegre Etme

DeepLX için temel kullanım durumlarından biri, resmi API maliyetlerine katlanmadan diğer uygulamalarda çeviri özelliklerini güçlendirmektir. Birkaç araç ve proje zaten entegrasyonları göstermiştir:

Entegrasyon İçin Genel Yaklaşım

  1. DeepLX Örneğinizi Kurun: DeepLX sunucunuzun çalıştığından ve onu kullanacak uygulamadan erişilebilir olduğundan emin olun.
  2. Yapılandırma Ayarlarını Belirleyin: Entegre etmek istediğiniz uygulamada, çeviri hizmetleri veya DeepL API ile ilgili ayarları arayın.
  3. DeepLX Uç Noktanıza İşaret Edin: Resmi bir DeepL API URL'si (https://api-free.deepl.com/v2/translate veya https://api.deepl.com/v2/translate gibi) yerine, genellikle DeepLX sunucunuzun adresini (örneğin, http://localhost:1188/translate veya http://your-server-ip:1188/translate) gireceksiniz.
  4. API Anahtarı İşleme:
  1. İyice Test Edin: Yapılandırmadan sonra, uygulamanızdaki çeviri işlevselliğinin DeepLX arka ucunuzla doğru çalıştığından emin olmak için test edin.

Entegrasyon kolaylığı büyük ölçüde, hedef uygulamanın çeviri hizmeti yapılandırmasının ne kadar esnek olduğuna bağlıdır.

Gelişmiş Hususlar ve En İyi Uygulamalar

DeepLX'ten en iyi şekilde yararlanmak ve olası sorunlarının bir kısmını azaltmak için aşağıdakileri göz önünde bulundurun:

Proaktif olarak, DeepLX kurulumunuzun istikrarını ve faydasını artırabilirsiniz.

Yaygın DeepLX Sorunlarını Giderme

DeepLX'in doğası göz önüne alındığında sorunlarla karşılaşmak mümkündür. İşte bazı yaygın sorunlar ve bunlara nasıl yaklaşılacağı:

Sorun: 429 Too Many Requests Hatası

Explore more

Fathom-R1-14B: Hindistan'dan Gelişmiş Yapay Zeka Muhakeme Modeli

Fathom-R1-14B: Hindistan'dan Gelişmiş Yapay Zeka Muhakeme Modeli

Yapay zeka hızla gelişiyor. FractalAIResearch/Fathom-R1-14B, 14.8 milyar parametreyle matematik ve genel akıl yürütmede başarılı.

5 June 2025

Mistral Code: İşletmeler için En Özelleştirilebilir Yapay Zeka Destekli Kodlama Asistanı

Mistral Code: İşletmeler için En Özelleştirilebilir Yapay Zeka Destekli Kodlama Asistanı

Mistral Code'u keşfedin: Kurumsal kullanıma özel, en özelleştirilebilir yapay zeka destekli kodlama asistanı.

5 June 2025

Claude Code'un 2025'te Yapay Zeka Kodlamasını Nasıl Dönüştürdüğü

Claude Code'un 2025'te Yapay Zeka Kodlamasını Nasıl Dönüştürdüğü

Claude Code, 2025'te yapay zeka destekli kodlamayı nasıl devrimleştiriyor? Özelliklerini, kullanımını ve Windsurf kısıtlamalarından sonra neden popüler olduğunu öğrenin. Geliştiriciler için okunması gereken!

5 June 2025

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir