EMZETT.DeepL API
Kısaca: Metinleri programatik olarak bir dilden diğerine çevirmeni sağlayan bir çeviri API’si; birçok alternatiften belirgin biçimde daha doğal duyulan çevirileriyle tanınır.
Biraz daha ayrıntılı: Bir API anahtarıyla çalışır (DEEPL_API_KEY); ücretsiz “API Free” planı küçük projeler için yeterlidir. Pratik bir kalıp: anahtar eksikse kod çökmek yerine temiz biçimde kaynak dile döner; tıpkı diğer isteğe bağlı hizmetlerde olduğu gibi (örneğin Cloudflare Turnstile, Pusher).
Bizim bağlamımız: Emzett’te next-intl’in kapsamadığı içeriği (next-intl yalnızca sabit kodlanmış arayüz metinlerini işleyebildiği için, veri tabanı içeriğini değil) otomatik çevirir: haberler, bülten e-postaları ve push bildirimleri kaydedilirken otomatik olarak İngilizceye çevrilir ve her alıcıya kayıtlı dilinde iletilir.
Ayrıntılı
Makine çevirisi kabaca iki nesle ayrılabilir: kelime kelime ya da büyük çeviri çifti istatistiklerine dayanarak çeviren eski istatistiksel/kural tabanlı sistemler ve tüm cümlelere bağlam içinde bakan, sinir ağlarına (derin öğrenme) dayalı yeni sistemler. DeepL ikinci nesle aittir; 2017’de dil öğrenme şirketi Linguee’den doğdu — Linguee’nin yıllar içinde topladığı insan çevirisi cümle çiftlerinin dev koleksiyonu, bir sinirsel çeviri modelinin gerektirdiği eğitim verisini tam olarak sağladı. DeepL, çeviriyi birçok yetenekten yalnızca “yan olarak” beceren genel amaçlı bir dil modelinin (örneğin GPT veya Claude) aksine, bilerek çeviri kalitesine uzmanlaşmıştır — kör testlerde DeepL, özellikle Avrupa içinde birçok dil çiftinde, en çok deyimsel ifadelerde ve sözcük sırasında Google Translate’ten düzenli olarak daha iyi sonuç verir.
API parametreleri ve resmîlik
Entegrasyon için pratik olarak önemli: API kaynak dil (isteğe bağlı; atlanırsa dil tanıma ile otomatik belirlenir) ile hedef dil (zorunlu) arasında ayrım yapar ve resmî/samimi “sen/siz” ayrımı olan diller için (Almanca, Fransızca ve diğerleri) bir formality parametresi sunar — kaynak metin daha samimi yazılmış olsa bile tutarlı biçimde resmî hitap kullanması gereken iş iletişimi için kullanışlıdır. Sık rastlanan bir tuzak, metindeki HTML/Markdown biçimlendirmesidir — özel işlem yapılmadan API etiketlerin içindeki içeriği de çevirir veya Markdown sözdizimini değiştirir, bu da biçimlendirmeyi bozabilir; bunun için API, belirli etiketleri çeviri sırasında yapısal olarak dokunulmadan bırakan ve yalnızca aralarındaki metin içeriğini aktaran bir tag_handling kipi ("html" veya "xml") sunar.
const result = await fetch("https://api-free.deepl.com/v2/translate", {
method: "POST",
headers: { Authorization: `DeepL-Auth-Key ${process.env.DEEPL_API_KEY}` },
body: new URLSearchParams({ text, target_lang: "EN", formality: "more" }),
})Geri dönüş stratejisi ve sınırlar
Sağlam bir entegrasyon kalıbı DeepL’i kesin bir bağımlılık değil, isteğe bağlı bir iyileştirme olarak ele alır: API anahtarı eksikse, istek başarısız olursa ya da ücretsiz “API Free” planının kotası (ayda 500.000 karakter) dolarsa uygulama tamamen çökmek yerine temiz biçimde kaynak dile dönmelidir — diğer isteğe bağlı hizmetlerle (örneğin Cloudflare Turnstile, Pusher) aynı kalıp. Ayrıca hukuken bağlayıcı veya özellikle hassas metinlerin (şartlar ve koşullar, tıbbi içerik) makine çevirisinin her zaman bir insan tarafından kontrol edilmesi önemlidir — DeepL iyidir ama hatasız değildir ve hukuki metinlerdeki çeviri hataları gerçek sonuçlar doğurabilir.
Alternatiflerle karşılaştırma
Google Cloud Translation çok daha fazla dili kapsar (DeepL’in yaklaşık 30’una karşılık 100’ün üzerinde), ancak Avrupa dil çiftlerinde ifadesi daha az doğal olma eğilimindedir. Microsoft Translator, Microsoft ekosistemiyle (Office, Azure) iyi entegrasyonuyla öne çıkar. Öncelikle Avrupa dilleri arasında çeviri yapan ve doğal duyulan sonuçlara değer veren bir proje için DeepL genellikle daha iyi seçimdir; çok sayıda veya egzotik dil çifti için (örneğin Almanca–Svahili) Google çoğu zaman tek pratik kapsamı sunar.