Gyakran ismételt kérdések
Minden, amit tudnod kell az i18n-keylessről, mielőtt elkezdenéd.
Szükséges a fordítási fájlok kezelése?
Nem. Nincsenek JSON fájlok, nincs kulcsextrakciós lépés, és nincs build-time bővítmény. A mondatait a forrásnyelvén írja meg, az SDK az első kéréskor elküldi őket az API-nak, az API pedig AI-vel fordítja le, és minden további kérés a gyorsítótárból kerül kiszolgálásra. A kódja az egyetlen igazságforrás.
Mi történik, amikor megváltoztatom a forrás szöveget?
A forrásszöveg a kulcs. Ha megváltoztatod, egy új kulcsot kapsz egy friss AI-fordítással. A régi kulcs egyszerűen nem lesz többé igényelve, a vezérlőpult pedig 30 nap használat nélkül automatikusan törli. A helyesírási hiba javítása is ugyanígy működik: javítsd ki a kódban, telepítsd, és az új szöveg az első kérésre lefordítódik.
Mennyibe kerül?
Önhostolt: teljesen ingyenes, korlátlan projektek, nincs előfizetés és nincs használati korlát — telepítse a Docker képet, használja a saját AI kulcsát. Tetszik? Adj egy tippet! Hostolt: egy fix ár projektenként havonta, havi aktív felhasználók alapján — 4 €-ig 1 000-ig, 9 €-ig 5 000-ig, 29 €-ig 50 000-ig, 99 €-ig 500 000-ig — havi számlázás, bármikor lemondható. Nincs árazás székenként, szó szerint vagy karakterlánconként egyik esetben sem.
Kivehetném-e a fordításaimat?
Igen. A vezérlőpultnak van egy „JSON exportálás” gombja, amely letölti a projektje összes fordítását egy JSON fájlként. A kivitel minden sort tartalmaz, nem csak azokat, amelyeket az elmúlt 30 napban használtak, így ez egy teljes biztonsági mentés. Nincs lekötés: az adatai mindig csak egy kattintásnyira vannak.
Milyen keretrendszereket támogat?
React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift és Kotlin. Minden SDK ugyanúgy működik: csomagold be a szöveged egy fordítási hívásba, és az API visszaadja a fordítást a jelenlegi nyelvre. A szerver SDK-k szálbiztosak és a memóriában tárolják a fordításokat.
Hány nyelvet támogat?
48 nyelv, beleértve a regionális változatokat is, mint a zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR és az es / es-MX. Az arab, héber és urdu is szerepel a listán, tehát a jobbról-balra író nyelvek is működnek. Egy új nyelv hozzáadása a projektedhez egyetlen kattintás a vezérlőpulton.
Működik ez kiszolgáló oldali rendereléssel?
Igen. A Node.js SDK az AsyncLocalStorage-t használja, így a betöltőitek, head függvényeitek és szerver komponenseitek lefordíthatók React szolgáltató nélkül. A kliens oldalon a React szolgáltató a szerveren renderelt HTML-ből hidratál. A dokumentációban lépcsőzetes útmutatók találhatók a Next.js-hez, a Nuxt-hoz és a TanStack Start-hoz.
Lassítja az alkalmazásomat?
Amikor először kérnek egy új karakterláncot, az API meghívja az AI modellt — kb. fél másodperc egy rövid UI karakterlánc esetében, több egy bekezdésnél. Minden további kérés a adatbázisból kerül kiszolgálásra, ami egy szokásos cache találat. Az SDK a fordításokat is helyi memóriában tárolja, így a visszatérő felhasználók nem tapasztalnak hálózati késleltetést. Ha tízen kérnek egyszerre ugyanazt a karakterláncot, akkor csak egy AI hívás történik.
Mi történik, ha a szolgáltatás leáll?
Minden SDK helyi szinten tárolja a fordításokat — a weben a localStorage-ban, mobilon az AsyncStorage-ban, a szerveren pedig a memóriában. Ha az API nem elérhető, az SDK a tárolt fordításokat szolgálja fel. A felhasználóid a legutolsó ismert fordítást látják, soha nem egy üres karakterláncot. Amikor az API visszatér, az SDK néma módon frissül.
Melyik AI szolgáltatót használja?
Öt szolgáltató támogatott: Mistral, OpenAI, Anthropic, Google, valamint bármely OpenAI-kompatibilis végpont, például az Ollama, a Groq vagy a Together. A kezelő a szolgáltatót és a modellt a vezérlőpultról vagy a környezetből választja ki. Az alapértelmezett beállítás az i18n-keyless.com-on a Mistral. A saját maguk által hosztolt felhasználók futtathatják az Ollamot helyi szinten, és semmit sem küldenek harmadik félnek.
Felülírhatok egy AI-fordítást?
Igen. Kattintson a vezérlőpult bármelyik cellájára, írja be a helyes szöveget, majd mentse. A javítás végleges: az API soha nem ír felül egy kézzel beállított értéket. A fordításokat felül is írhatja az API-n vagy az MCP-szerveren keresztül, így egy AI-kódoló ügynök javíthatja a fordítást Önnek.
Át tudok-e migrálni az i18next-ről vagy egy másik könyvtárból?
Igen. A dokumentációban létezik egy lépésről lépésre haladó migrációs útmutató az i18next, react-intl és a Lokalise számára. Az API rendelkezik egy migrációs végponttal, amely egyenként importálja a meglévő fordításait, AI-hívás vagy számlázás nélkül. Az MCP-kiszolgáló ugyanazt az eszközt tartalmazza, így egy AI-ügynök elvégezheti helyetted a migrációt.
Van ingyenes terv?
A saját szerveren futtatott verzió teljesen ingyenes korlátlan projektekkel — telepítse a Docker képet, használja a saját AI kulcsát, és tartsa az adatokat a saját szerverén. Nincs időkorlát, nincsenek funkciókorlátozások. A felhőben futtatott verzió havi 4 euróról kezdődik projektenként, ha nem szeretne szervert futtatni.
Elérhető a forráskód?
A szerver, a vezérlőpult és a Docker-kép az Elastic License 2.0 alatt kerül közzétételre a GitHubon. Minden sort elolvashat, futtathatja a kódot, és módosíthatja azt. Az SDK-k — React, Vue, Node, Rails és a többi — MIT licenc alatt állnak. Az egyetlen korlátozás: nem nyújthatja a szoftvert harmadik felek számára hosted szolgáltatásként.
Egy karbantartó: mi történik, ha a projekt leáll?
A SDK-k MIT licenc alatt állnak, és elérhetők maradnak az npm, PyPI, RubyGems és más regisztereken. A szerver nyilvános az Elastic License 2.0 alatt, és a köztük lévő protokoll dokumentált, így bárki futtathatja, fork-olhatja, vagy írhat ellene egy szervert. A fordításait egy JSON exportban tárolja bármikor. Ha a hosted szolgáltatás leáll: a telepített alkalmazások továbbra is szolgáltatják a gyorstárazott fordításaikat, egy új kliens visszaugrik a forrásnyelvre, és az SDK-t a saját példányodra az API_URL-lel irányítva minden visszaáll. Amit elveszítenél, az az új karakterláncok AI-fordítása az i18n-keyless.com-on — nem az adataidat vagy az alkalmazásodat.
Olvassa el a teljes választ a kóddal együttA kontextus nem más, mint egy álruhás kulcs?
Nem. Minden karakterlánchoz kötelező egy kulcs, egyedinek kell lennie, és egy kézzel karbantartott globális névtérben létezik. A kontextus opcionális, csak néhány olyan karakterlánchoz kapcsolódik, amelyeknek a jelentése nem egyértelmű — például a „Close” jelentése lehet ablak bezárása vagy távolság szerinti bezárás — és a jelentést írja le, nem a karakterláncot nevezi meg. A legtöbb karakterlánchoz nem tartozik kontextus. Az eredeti szöveg marad a keresés alapja, kontextussal vagy anélkül; két azonos szöveg két kontextussal egyszerűen két sor.
Olvassa el a teljes választ a kóddal együttMegnézhetem a másolatot egy pull requestben?
Igen. A forrásstring a kódban van, így minden megfogalmazásbeli változás egy olyan különbség, amit a lektor a pull requestben olvas egyszerű nyelven a kulcsnév helyett. Ami nincs a gitben, az a többi nyelv fordítása: az a adatbázisban van, mint bármely más fordítási platformon, és az irányítópulton tekintheted meg, ahol egy cellánkénti "áttekintett" jelölés elkülöníti azt, amit egy ember ellenőrzött attól, amit az AI írt, vagy a JSON exportban.
Olvassa el a teljes választ a kóddal együttMiért ne Tolgee, amely szintén nyílt forráskódú?
A Tolgee egy kulcsalapú fordítási platform az Apache 2.0 licenc alatt, kontextusba illesztett szerkesztéssel, képernyőkép-kontextussal és fordítási memóriával; ha ezeket a funkciókat, vagy fordítókat szeretnéd a folyamatban, akkor jó választás. Az i18n-keyless nem rendelkezik kulcsokkal, nincsenek helyi fájlok, az AI-fordítás alapértelmezés szerint aktív egy manuális felülírással, amelyet az AI soha nem ír át újra, egy Elastic License 2.0 alatt lévő szerver MIT SDK-kkal, valamint egy önmagában futtatható kép, amely SQLite-n fut egy konténerben. Kontextusba illesztett javításhoz készíts egy képernyőképet, és adj egy MCP-szerverhez csatlakoztatott AI-ügynöknek: az megtalálja a szöveget, és felülírja a fordítást. A dokumentáció összehasonlító oldala a prixokat egymás mellett mutatja.
Olvassa el a teljes választ a kóddal együttÖnhostozott vagy előfizetés: melyik?
Önhostozott: ugyanaz a Docker-kép a saját szerverén, teljesen ingyenes korlátlan projektekkel, a saját AI-kulcsával és az adatai otthon. Tetszik? Adj egy tippet! Előfizetés: mi futtatjuk, a frissítések automatikusak, fix áron 4 euró havonta projektenként. Válassza az előfizetést, ha nem szeretne szervert futtatni.
Olvassa el a teljes választ a kóddal együttHogyan kezeljem a dinamikus értékeket, például a neveket vagy a számokat?
Használja a cserélő lehetőséget. Írja a mondatot egy helyőrzővel — „Helló {name}, {count} elem van nálad” — és a rendereléskor adja át a értékeket a replace segítségével: { "{name}": userName, "{count}": String(n) }. Az AI látja a helyőrzőt, és minden fordításban megtartja. Az SDK futásidőben helyettesíti az értéket.
Hogyan kezelem a többes számokat?
Írj egy formát a {count} számára, ahol a szám beillesztésre kerül, és add át a számot count-ként. Az API minden nyelvhez egy ICU többes számú üzenetet tárol a nyelv által igényelt formákkal — kettő franciául, négy oroszul, hat arabul — az Intl.PluralRules ellenőrzése mellett, és az SDK kiválasztja a megfelelőt. Rendelési számokat (1st, 2nd) adj hozzá. Soha ne írj magad ágakat.
Olvassa el a teljes választ a kóddal együttHogyan kezeljem a nemeket?
Adja át az értéket a select-ben — select={{ gender: "nő" }} — és a modell egy változatot ír minden értékre, minden nyelven, figyelembe véve a nyelvi igényeket. Az értékek zárt halmazból származó azonosítók, legfeljebb 10 változóként és 2 változó mondatonként; a select és a count kombinálható. A nyitott értékek, mint például egy név, helyettesítésként maradnak.
Olvassa el a teljes választ a kóddal együttHogyan formázhatom a dátumokat, számokat és valutákat?
Az SDK nem formázza őket, ezt a futásidejű környezet végzi. Használja az Intl.DateTimeFormat és Intl.NumberFormat függvényeket az SDK aktuális nyelvével, majd helyezze az eredményt a mondatba a replace segítségével. Egy mondat, egy fordítás, a helyes formátum minden nyelvben.
Olvassa el a teljes választ a kóddal együttTestreszabhatom-e a fordítási promptot?
Nem, és neked sem kell ezt megtenned. A prompt olvassa a kontextusod minden kulcshoz: itt alakul ki a hangnem, a célközönség és a jelentés, és ez az, ami miatt ugyanaz a szó két helyen másként fordul le. És bármelyik fordítást kézzel felülírhatod a vezérlőpulton; az API soha nem írja felül azt, amit te írtál.
Olvassa el a teljes választ a kóddal együttVan-e MCP-szerver AI-kódoló ügynökökhöz?
Igen. Az API egy OAuth 2.1-es hitelesítéssel rendelkező MCP-kiszolgáló. Egy AI-ügynök listázhat fordításokat, karakterláncokat fordíthat, felülírhat értékeket, importálhat létező fordításokat és kezelheti a projekt tagjait — ugyanazokat a műveleteket, amelyeket egy ember a vezérlőpulton végez. Csatlakoztassa a Claude Code-ból, a Cursor-ból, a Windsurfből vagy bármely MCP-kompatibilis kliensből.
Használhatom-e backend sztringekhez és e-mailekhez?
Igen. A Node.js, Ruby on Rails, Python és Go SDK-k a szerveren futnak. Fordítsa le egy e-mail tárgyát, egy hibauzenetet vagy egy push értesítést ugyanúgy, mint egy UI karakterláncot. A szerveroldali SDK-k a memóriában tárolják a fordításokat, és a háttérben frissítik őket, így nem adnak hozzá késleltetést a kéréséhez.
Az egész csapatom dolgozhat a fordításokon?
Igen. Adja hozzá a csapattagokat a projekthez a vezérlőpultból vagy az API-n keresztül. Minden tag láthatja az összes fordítást, felülírhat bármely értéket és nyelveket adhat hozzá. A rendszergazdák projekteket hoznak létre és kezelik a tagokat. Nincs ülőhelyenkénti árazás: adjon hozzá annyi embert, amennyire szüksége van.
Hogyan javíthatok ki egy gépelési hibát?
A forrás szöveg a kulcs. Ha kijavítasz egy elütést a forrás szövegben, új kulcsot kapsz egy friss fordítással; a régi szöveg egyszerűen nem lesz többé lekérdezve, és a vezérlőpult 30 nap használat nélkül automatikusan törli. Fordítási elütés: szerkeszd a cellát a vezérlőpulton, és a javítás végleges lesz.
Olvassa el a teljes választ a kóddal együtt