Sıkça sorulan sorular

Başlamadan önce i18n-keyless hakkında bilmeniz gereken her şey.

Çeviri dosyalarını yönetmem gerekir mi?

Hayır. JSON dosyaları yok, anahtar çıkarma adımı yok ve derleme zamanı eklentisi yok. Kaynak dilinizde cümlelerinizi yazarsınız, SDK ilk istekle onları API'ye gönderir, API onları AI ile tercüme eder ve her sonraki istek önbellekten sunulur. Kodunuz tek gerçek kaynaktır.

Kaynak metni değiştirdiğimde ne olur?

Kaynak metin anahtardır. Değiştirirseniz, taze bir AI çevirisiyle yeni bir anahtar elde edersiniz. Eski anahtar artık talep edilmez ve kontrol paneli 30 gün kullanılmadığında onu temizler. Bir yazım hatası düzeltmesi de aynı şekilde çalışır: koddaki hatayı düzeltin, yayınlayın ve yeni metin ilk talepte çevrilir.

Fiyatı ne kadar?

Kendi barındırılan: tamamen ücretsiz, sınırsız projeler, abonelik yok ve kullanım sınırı yok — Docker görüntüsünü yükleyin, kendi AI anahtarınızı kullanın. Beğendiniz mi? Bana bahşiş verin! Barındırılan: aylık aktif kullanıcılara göre proje başına sabit bir fiyat — 1.000'e kadar 4 €, 5.000'e kadar 9 €, 50.000'e kadar 29 €, 500.000'e kadar 99 € — aylık faturalandırılır, herhangi bir zamanda iptal edilebilir. Her iki durumda da koltuk başına, kelime başına veya dize başına fiyatlandırma yoktur.

Çevirilerimi dışa aktarabilir miyim?

Evet. Kontrol paneli, projenizdeki tüm çevirileri tek bir JSON dosyası olarak indiren bir "JSON Dışa Aktar" düğmesine sahiptir. Dışa aktarma, son 30 günde kullanılanlar da dahil olmak üzere tüm satırları içerir, bu nedenle tam bir yedeklemedir. Kilitlenme yok: verileriniz her zaman sadece bir tık uzağınızda.

Hangi framework'leri destekliyor?

React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift ve Kotlin. Her SDK aynı şekilde çalışır: metninizi bir çeviri çağrısına sarın ve API mevcut dil için çeviriyi döndürür. Sunucu SDK'ları thread-safe olup çevirileri bellekte önbelleğe alır.

Desteklenen kaç dil var?

48 dil, bölgesel varyantlar dahil olmak üzere zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR ve es / es-MX gibi. Arapça, İbranice ve Urdu da listede yer alıyor, bu yüzden sağdan sola yazılan diller de çalışıyor. Projenize yeni bir dil eklemek panodaki bir tıklamayla mümkün.

Sunucu tarafı render ile çalışıyor mu?

Evet. Node.js SDK, AsyncLocalStorage kullanarak yükleyicilerinizin, head fonksiyonlarının ve sunucu bileşenlerinin React sağlayıcısına gerek kalmadan çeviri yapabilmesini sağlar. İstemci tarafında, React sağlayıcısı sunucu tarafından oluşturulan HTML'den hidratasyon yapar. Dokümantasyonda Next.js, Nuxt ve TanStack Start için adım adım kılavuzlar bulunmaktadır.

Bu, uygulamamı yavaşlatır mı?

Yeni bir dize ilk kez talep edildiğinde, API yapay zeka modelini çağırır — kısa bir kullanıcı arayüzü dizgesi için yaklaşık yarım saniye, paragraf için daha uzun sürer. Bundan sonraki her talep veritabanından karşılanır, bu da normal bir önbellek erişimidir. SDK ayrıca çevirileri yerel olarak önbelleğe alır, böylece geri dönen kullanıcılar hiçbir ağ gecikmesi görmez. Aynı anda on kullanıcı aynı dizeyi talep ederse, yalnızca bir yapay zeka çağrısı yapılır.

Hizmet durursa ne olur?

Her SDK yerel olarak çevirileri önbelleğe alır — web'de localStorage'da, mobilde AsyncStorage'da ve sunucuda bellekte. API'ye ulaşılamazsa, SDK önbelleğe alınmış çevirileri sunar. Kullanıcılarınız son bilinen çeviriyi görür, asla boş bir dize değil. API geri döndüğünde, SDK sessizce yenilenir.

Hangi AI sağlayıcısını kullanıyor?

Beş sağlayıcı desteklenmektedir: Mistral, OpenAI, Anthropic, Google ve Ollama, Groq veya Together gibi OpenAI uyumlu herhangi bir uç nokta. Operatör, sağlayıcıyı ve modeli kontrol panelinden veya ortamdan seçer. i18n-keyless.com'daki varsayılan ayar Mistral'dir. Kendi barındıran kullanıcılar Ollama'yı yerel olarak çalıştırabilir ve üçüncü bir tarafa hiçbir şey göndermez.

Bir AI çevirisini geçersiz kılabilir miyim?

Evet. Kontrol panelindeki herhangi bir hücreye tıklayın, doğru metni yazın ve kaydedin. Düzeltme kalıcıdır: API, elle ayarlanan bir değeri asla üzerine yazmaz. Ayrıca API veya MCP sunucusu aracılığıyla çevirileri geçersiz kılabilirsiniz, böylece bir AI kodlama aracı sizin için bir çeviriyi düzeltebilir.

i18next veya başka bir kütüphaneden geçiş yapabilir miyim?

Evet. Dokümantasyonda i18next, react-intl ve Lokalise için adım adım geçiş kılavuzu bulunmaktadır. API, mevcut çevirilerinizi tek tek içe aktaran bir geçiş uç noktasına sahiptir; herhangi bir AI çağrısı veya faturalandırma yapılmaz. MCP sunucusunda aynı araç bulunur, böylece bir AI ajanı geçişi sizin için gerçekleştirebilir.

Ücretsiz bir plan var mı?

Kendi barındıran sürüm, sınırsız projelerle tamamen ücretsizdir — Docker görüntüsünü yükleyin, kendi AI anahtarınızı kullanın ve verilerinizi kendi sunucunuzda saklayın. Zaman sınırı yok, özellik kısıtlaması yok. Barındırılan plan, bir sunucu çalıştırmak istemiyorsanız her proje için ayda 4 avrodan başlar.

Kaynak kodu mevcut mu?

Sunucu, kontrol paneli ve Docker görüntüsü GitHub'da Elastic License 2.0 altında yayınlanmaktadır. Her satırı okuyabilir, kodu çalıştırabilir ve değiştirebilirsiniz. SDK'lar — React, Vue, Node, Rails ve diğerleri — MIT lisansı altındadır. Tek kısıtlama: yazılımı barındırılan bir hizmet olarak üçüncü taraflara sunamazsınız.

Bir bakımcı: proje durursa ne olur?

SDK'ler MIT lisansı altındadır ve npm, PyPI, RubyGems ve diğer kayıt yerlerinde bulunabilir. Sunucu Elastic License 2.0 altında kamu erişimine açıktır ve aralarındaki protokol belgelenmiştir, bu nedenle herkes onu çalıştırabilir, fork yapabilir veya ona karşı bir sunucu yazabilir. Çevirileriniz her zaman tek bir JSON dışa aktarımında kalır. Barındırılan hizmet durdurulursa: yüklü uygulamalar önbelleğe alınmış çevirilerini sunmaya devam eder, yeni bir istemci kaynak dile geri döner ve SDK'yı API_URL ile kendi örneğinize yönlendirerek her şeyi geri yükleyebilirsiniz. Kaybedeceğiniz şey, i18n-keyless.com'daki yeni dizelerin AI çevirisi — verileriniz ya da uygulamanız değil.

Tam cevabı, kodla birlikte okuyun
Bağlam sadece gizlenmiş bir anahtar değil mi?

Hayır. Her dize için bir anahtar zorunludur, benzersiz olmalıdır ve elle yönettiğiniz global bir ad alanı içinde bulunur. Bağlam isteğe bağlıdır, anlamı belirsiz olan birkaç dizeye eklenir — örneğin "Close", pencereyi kapatmak ya da mesafeye göre "kapamak" anlamına gelebilir — ve anlamı açıklar, dizeyi adlandırmak yerine. Çoğu dizenin bağlamı yoktur. Kaynak metin, bağlamlı ya da bağlamsız olarak arama için temel kalır; iki özdeş metnin iki bağlamı varsa, bunlar sadece iki satırdır.

Tam cevabı, kodla birlikte okuyun
Bir pull request'te kopyayı gözden geçirebilir miyim?

Evet. Kaynak dize kodda yer aldığından, her kelime değişikliği bir farktır ve inceleyici bunu pull isteğinde anahtar adı yerine düz dilde okur. Git'te olmayan şey diğer dillere yapılan çevirilerdir: bunlar herhangi bir çeviri platformunda olduğu gibi veritabanında bulunur ve kontrol panelinde incelenir, burada hücre başına "incelendi" işareti bir kişi tarafından kontrol edilen ile yapay zekanın yazdıkları arasındaki farkı ayırır ya da JSON dışa aktarımında.

Tam cevabı, kodla birlikte okuyun
Neden de açık kaynak olan Tolgee?

Tolgee, Apache 2.0 lisansı altında çalışan, anahtar tabanlı bir çeviri platformudur; bağlam içi düzenleme, ekran görüntüsü bağlamı ve çeviri belleği sunar. Bu özellikleri ya da sürecinizde çevirmenleri istiyorsanız iyi bir seçimdir. i18n-keyless'te anahtarlar yok, yerelleştirme dosyaları yok, varsayılan olarak AI çevirisi etkindir ve AI'nin asla yeniden yazmadığı elle yapılan geçersiz kılma işlemiyle birlikte, MIT SDK'larla birlikte Elastic License 2.0 altında bir sunucu ve tek bir konteynerde SQLite üzerinde çalışan kendi barındırılan bir görüntü bulunur. Bağlam içi düzeltme için bir ekran görüntüsü alın ve bunu MCP sunucusuna bağlı bir AI aracısına verin: o dizesini bulur ve çeviriyi geçersiz kılar. Dokümantasyonundaki karşılaştırma sayfası fiyatları yan yana gösterir.

Tam cevabı, kodla birlikte okuyun
Kendi barındırılan mı yoksa abonelik mi: hangisi?

Kendi barındıran: kendi sunucunuzdaki aynı Docker görüntüsü, sınırsız projelerle tamamen ücretsiz, kendi AI anahtarınız ve evdeki verilerinizle. Beğendiniz mi? Bana bahşiş verin! Abonelik: biz yönetiyoruz, güncellemeler otomatik, projeler için aylık sabit fiyat 4 €'dan başlıyor. Bir sunucu çalıştırmak istemiyorsanız aboneliği alın.

Tam cevabı, kodla birlikte okuyun
Adlar veya sayılar gibi dinamik değerleri nasıl işlerim?

Değiştirme seçeneğini kullanın. Yer tutucuyla cümleyi yazın — "Merhaba {name}, {count} öğeniz var" — ve render sırasında değerleri replace ile geçirin: { "{name}": userName, "{count}": String(n) }. Yapay zeka yer tutucuyu görür ve her çeviride korur. SDK, çalışma zamanında değeri değiştirir.

Çoğul biçimleri nasıl ele alırım?

{count} içeren bir biçim yazın, sayı oraya yerleştirilir ve sayıyı count olarak geçirin. API, dilin ihtiyaç duyduğu tam biçimlerle (Fransızcada iki, Rusçada dört, Arapçada altı) her dil için bir ICU çoğul mesajı saklar — Intl.PluralRules ile kontrol edilir ve SDK doğru olanı seçer. Sıralamalar için sıra sayıları ekleyin (1st, 2nd). Kendi dallarınızı asla yazmazsınız.

Tam cevabı, kodla birlikte okuyun
Cinsiyetleri nasıl ele alırım?

Değeri select'te geçirin — select={{ gender: "kadın" }} — ve model her değer için her dilde bir varyant yazar, dil ihtiyaçlarını dikkate alarak. Değerler kapalı bir settendir, en fazla 10 değişken başına ve cümle başına 2 değişken; bir select ve bir count birleştirilebilir. Bir isim gibi açık değerler yerini korur.

Tam cevabı, kodla birlikte okuyun
Tarihleri, sayıları ve para birimlerini nasıl biçimlendiririm?

SDK onları biçimlendirmez, bunu çalışma zamanı yapar. SDK'daki mevcut dil ile Intl.DateTimeFormat ve Intl.NumberFormat kullanın ve ardından sonucu replace ile cümleye yerleştirin. Bir cümle, bir çeviri, her dilde doğru biçim.

Tam cevabı, kodla birlikte okuyun
Çeviri istemini özelleştirebilir miyim?

Hayır, bunu yapmanıza gerek yok. İpucu her anahtar için bağlamınızı okur: ton, hedef kitle ve anlamın belirlendiği yer burasıdır ve aynı kelimenin iki farklı yerde farklı şekilde çevrilmesini sağlayan da budur. Ve herhangi bir çeviri panoda elle geçersiz kılınabilir; API asla yazdıklarınızı üzerine yazmaz.

Tam cevabı, kodla birlikte okuyun
AI kodlama ajanları için bir MCP sunucusu var mı?

Evet. API ayrıca OAuth 2.1 kimlik doğrulaması olan bir MCP sunucusudur. Bir AI ajanı, çevirileri listeleyebilir, dizeleri çevirebilir, değerleri geçersiz kılabilir, mevcut çevirileri içe aktarabilir ve proje üyelerini yönetebilir — insanların kontrol panelinde yaptığı aynı işlemler. Bunu Claude Code, Cursor, Windsurf veya herhangi bir MCP uyumlu istemciden bağlayın.

Arka uç dizesi ve e-postalar için kullanabilir miyim?

Evet. Node.js, Ruby on Rails, Python ve Go SDK'leri sunucuda çalışır. Bir e-posta konusunu, hata mesajını veya push bildirimini bir UI dizesini çevirdiğiniz şekilde çevirin. Sunucu SDK'leri çevirileri bellekte önbelleğe alır ve arka planda yeniler, böylece isteğinize gecikme eklemezler.

Tüm takımım çeviriler üzerinde çalışabilir mi?

Evet. Projeye ekip üyelerini kontrol panelinden veya API aracılığıyla ekleyin. Her üye tüm çevirileri görebilir, herhangi bir değeri geçersiz kılabilir ve diller ekleyebilir. Yöneticiler projeler oluşturur ve üyeleri yönetir. Koltuk başına fiyatlandırma yok: ihtiyacınız kadar kişi ekleyin.

Yazım hatasını nasıl düzeltebilirim?

Kaynak metin anahtardır. Kaynak metindeki bir yazım hatasını düzeltirseniz, yeni bir anahtar ve yeni bir çeviri alırsınız; eski dize artık talep edilmez ve kontrol paneli 30 gün kullanılmadığında otomatik olarak temizler. Bir çevirideki yazım hatası: kontrol panelindeki hücreyi düzenleyin ve düzeltme kalıcı olur.

Tam cevabı, kodla birlikte okuyun