Často kladené otázky
Všetko, čo potrebujete vedieť o i18n-keyless predtým, než začnete.
Musím spravovať súbory s prekladmi?
Nie. Žiadne JSON súbory, žiadny krok extrakcie kľúčov a žiadny plugin pre dobu zostavovania. Napíšte svoje vety vo svojom zdrojovom jazyku, SDK ich pošle do API pri prvom požiadavku, API ich preloží pomocou AI a každá ďalšia požiadavka je obslúžená z vyrovnávacej pamäte. Váš kód je jediným zdrojom pravdy.
Čo sa stane, keď zmením zdrojový text?
Zdrojový text je kľúč. Ak ho zmeníte, dostanete nový kľúč s novým prekladom AI. Starý kľúč sa prestane vyžadovať a ovládací panel ho po 30 dňoch nečinnosti odstráni. Oprava preklepu funguje rovnako: opravte ju v kóde, nasaďte a nový text bude preložený pri prvom požiadavku.
Koľko to stojí?
Samostatne hostované: úplne zadarmo, neobmedzené projekty, bez predplatného a bez limitu používania — nainštalujte si Docker image a použite svoj vlastný AI kľúč. Páči sa vám to? Dajte mi tip! Hostované: pevná mesačná cena za projekt podľa mesačne aktívnych používateľov — 4 € do 1 000, 9 € do 5 000, 29 € do 50 000, 99 € do 500 000 — účtované mesačne, môžete kedykoľvek zrušiť. V oboch prípadoch nie je žiadne cenové určenie za miesto, za slovo alebo za reťazec.
Môžem exportovať svoje preklady?
Áno. Nástenná doska má tlačidlo „Exportovať JSON“, ktoré stiahne všetky preklady vo vašom projekte ako jeden JSON súbor. Export zahŕňa všetky riadky, nie iba tie, ktoré sa použili za posledných 30 dní, takže ide o úplnú zálohu. Nie je žiadne obmedzenie: vaše dáta sú vždy len na jeden klik.
Ktoré frameworky podporuje?
React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift a Kotlin. Všetky SDK fungujú rovnako: zabalte svoj text do volania prekladov a API vráti preklad pre aktuálny jazyk. Serverové SDK sú thread-safe a ukladajú preklady do pamäte.
Koľko jazykov je podporovaných?
48 jazykov, vrátane regionálnych variant ako zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR a es / es-MX. Arabčina, hebrejčina a urdčina sú tiež na zozname, takže aj jazyky písané sprava doľava fungujú. Pridanie nového jazyka do vášho projektu je len jedno kliknutie v ovládacom paneli.
Funguje to s renderovaním na strane servera?
Áno. Node.js SDK používa AsyncLocalStorage, takže vaše loadery, head funkcie a serverové komponenty môžu prekladať bez nutnosti používať poskytovateľa React. Na strane klienta poskytovateľ React hydratuje z HTML vygenerovaného na serveri. V dokumentácii sú podrobné návody pre Next.js, Nuxt a TanStack Start.
Spomaľuje to moju aplikáciu?
Keď sa po prvýkrát požiada nový reťazec, API zavolá AI model — približne pol sekundy pre krátky reťazec používateľského rozhrania, dlhšie pre odsek. Všetky ďalšie požiadavky sú obslúžené z databázy, čo je bežný cache hit. SDK tiež ukladajú preklady lokálne, takže vrátení používatelia nevidia žiadne oneskorenie siete. Ak desať používateľov požiada o rovnaký reťazec súčasne, urobí sa iba jedno volanie AI.
Čo sa stane, ak služba prestane fungovať?
Každý SDK uklada preklady lokálne — v localStorage na webe, v AsyncStorage na mobilných zariadeniach a v pamäti na serveri. Ak sa k API nedá pripojiť, SDK poskytuje uložené preklady. Vaši používatelia vidia posledný známy preklad, nikdy prázdny reťazec. Keď sa API vráti, SDK sa ticho obnoví.
Ktorého poskytovateľa AI používa?
Je podporovaných päť poskytovateľov: Mistral, OpenAI, Anthropic, Google a akýkoľvek endpoint kompatibilný s OpenAI, ako je Ollama, Groq alebo Together. Operátor vyberá poskytovateľa a model z ovládacieho panelu alebo z prostredia. Predvolené nastavenie na i18n-keyless.com je Mistral. Užívatelia, ktorí si službu hostia sami, môžu spustiť Ollama lokálne a nič neposlať tretej strane.
Môžem prepísať preklad AI?
Áno. Kliknite na ľubovoľnú bunku v ovládacom paneli, zadajte správny text a uložte. Oprava je trvalá: rozhranie API nikdy neprepíše hodnotu, ktorú ste nastavili ručne. Môžete tiež prepísať preklady cez rozhranie API alebo cez server MCP, takže AI kódovací agent vám môže opravu prekladu.
Môžem migrovať z i18next alebo inej knižnice?
Áno. V dokumentácii je sprievodca krokovou migráciou pre i18next, react-intl a Lokalise. API má koncový bod pre migráciu, ktorý importuje vaše existujúce preklady jeden po druhom, bez akéhokoľvek volania AI alebo účtovania. MCP server má rovnaký nástroj, takže AI agent môže vykonať migráciu za vás.
Je nejaký bezplatný plán?
Samostatne hostená verzia je úplne zadarmo s neobmedzeným počtom projektov — nainštalujte si Docker image, použite svoj vlastný AI kľúč a uchovávajte svoje dáta na svojom vlastnom serveri. Žiadne časové obmedzenie, žiadne obmedzenia funkcií. Hostovaný plán začína na 4 eurách mesačne za projekt, ak nechcete prevádzkovať server.
Je zdrojový kód dostupný?
Server, dashboard a Docker image sú zverejnené na GitHube pod licenciou Elastic 2.0. Môžete si prečítať každý riadok, spustiť kód a zmeniť ho. SDK — React, Vue, Node, Rails a ďalšie — sú licencované pod MIT. Jediné obmedzenie: nesmiete poskytnúť softvér ako hostovanú službu tretím stranám.
Jeden správca: čo sa stane, ak sa projekt zastaví?
SDK sú pod MIT licenciou a zostávajú dostupné na npm, PyPI, RubyGems a ďalších registráciách. Server je verejný pod Elastic licenciou 2.0 a protokol medzi nimi je zdokumentovaný, takže ho môže ktokolvek spustiť, vytvoriť jeho fork alebo napísať proti nemu server. Vaše preklady zostávajú v jednom JSON exportu kedykoľvek. Ak hostovaná služba prestane fungovať: nainštalované aplikácie pokračujú v poskytovaní svojich uložených prekladov, nový klient sa vráti k východiskovému jazyku a nasmerovaním SDK na vlastnú inštanciu s API_URL sa všetko obnoví. To, čo by ste stratili, je AI preklad nových reťazcov na i18n-keyless.com — nie vaše dáta ani aplikáciu.
Prečítajte si celú odpoveď s kódomNie je kontext iba klúč v prezlečení?
Nie. Každý reťazec vyžaduje kľúč, ktorý musí byť jedinečný a nachádza sa v globálnom priestore mien, ktorý si ručne udržujete. Kontext je voliteľný a viaže sa k niekoľkým málo reťazcom, ktorých význam je nejednoznačný — napríklad „Close“ môže znamenať zatvoriť okno alebo „close“ v zmysle vzdialenosti — a opisuje význam, nie pomenúva reťazec. Väčšina reťazcov nemá kontext. Pôvodný text zostáva základom pre vyhľadávanie, s kontextom alebo bez neho; dva identické texty s dvoma kontextami sú jednoducho dva riadky.
Prečítajte si celú odpoveď s kódomMôžem prekontrolovať kópiu v pull requeste?
Áno. Zdrojový reťazec je v kóde, takže každá zmena znenia je rozdiel, ktorý recenzent číta v pull requeste v bežnom jazyku namiesto názvu kľúča. To, čo sa nenachádza v gite, sú preklady do ostatných jazykov: tieto sa nachádzajú v databáze, ako je tomu u ktoréhokoľvek prekladového nástroja, a prezeráte si ich v nástenke, kde značka "prekontrolované" pre každú bunku oddeľuje to, čo skontroloval človek od toho, čo napísala AI, alebo v JSON výpise.
Prečítajte si celú odpoveď s kódomPrečo nie Tolgee, ktoré je tiež open source?
Tolgee je platforma pre preklady založená na kľúčoch pod licenciou Apache 2.0, s úpravami v kontexte, kontextom snímkov obrazovky a prekladovou pamäťou. Ak tieto funkcie potrebujete alebo prekladateľov v procese, je to dobrá voľba. i18n-keyless nemá kľúče, nemá lokalizačné súbory, preklad pomocou AI je štandardne zapnutý s manuálnym prepísaním, ktoré AI nikdy neprepíše, server pod licenciou Elastic 2.0 s MIT SDK a samo-hostovaný obraz, ktorý beží na SQLite v jednom kontajneri. Pre opravu v kontexte urobte snímok obrazovky a pošlite ho AI agentovi pripojenému k MCP serveru: nájde reťazec a prepíše preklad. Stránka porovnania v dokumentácii zobrazuje ceny vedľa seba.
Prečítajte si celú odpoveď s kódomSamo-hostované alebo predplatné: ktoré?
Samostatne hostované: ten istý Docker obraz na vašom vlastnom serveri, úplne zadarmo s neobmedzenými projektmi, s vašim vlastným AI kľúčom a vašimi dátami doma. Páči sa vám to? Dajte mi sprepitné! Predplatné: my to spravujeme, aktualizácie sú automatické, pevná cena od 4 € mesačne za projekt. Vyberte si predplatné, ak nechcete spravovať server.
Prečítajte si celú odpoveď s kódomAko môžem pracovať s dynamickými hodnotami, ako sú mená alebo počty?
Použite možnosť nahradenia. Napíšte vetu s umiestňovacím miestom — „Ahoj {name}, máte {count} položiek“ — a počas renderovania preložte hodnoty pomocou replace: { "{name}": userName, "{count}": String(n) }. Umelej inteligencie vidí umiestňovacie miesto a zachováva ho v každom preklade. SDK nahrádza hodnotu počas behu.
Ako pracujem s plurálom?
Napíšte jeden tvar s {count}, kde sa číslo vloží, a preložte číslo ako count. API uklada jednu správu množného čísla ICU pre každý jazyk s presne takými tvarmi, ktoré jazyk potrebuje — dve vo francúzštine, štyri v ruštine, šesť v arabčine — overené pomocou Intl.PluralRules, a SDK vyberie správnu. Pridajte radové číslovky pre poradie (1st, 2nd). Nikdy sami nepíšete vetvy.
Prečítajte si celú odpoveď s kódomAko sa vysporiadam s pohlaviami?
Preložte hodnotu do select — select={{ gender: "žena" }} — a model napíše jednu variantu pre každú hodnotu, v každom jazyku, s ohľadom na jazykové potreby. Hodnoty sú identifikátory z uzavretej množiny, najviac 10 na premennú a 2 premenné na vetu; select a count sa môžu kombinovať. Otvorené hodnoty, ako je meno, zostávajú ako náhrada.
Prečítajte si celú odpoveď s kódomAko formátovať dátumy, čísla a meny?
SDK ich neformátuje, to robí váš runtime. Použite Intl.DateTimeFormat a Intl.NumberFormat s aktuálnym jazykom zo SDK a potom vložte výsledok do vety pomocou replace. Jedna veta, jeden preklad, správny formát v každom jazyku.
Prečítajte si celú odpoveď s kódomMôžem si prispôsobiť výzvu pre preklad?
Nie, a ani to nemusíš robiť. Výzva číta tvoj kontext pre každý kľúč: tam sa určuje tón, cieľová skupina a význam, a práve to spôsobuje, že sa rovnaké slovo prekladá rôzne na dvoch miestach. A ktorýkoľvek preklad sa dá v riadiacom paneli ručne prepísať; API nikdy neprepíše to, čo si napísal.
Prečítajte si celú odpoveď s kódomMá to MCP server pre AI kódovacie agenti?
Áno. API je tiež MCP server s autentifikáciou OAuth 2.1. AI agent môže zoznamovať preklady, prekladať reťazce, prepísať hodnoty, importovať existujúce preklady a spravovať členov projektu — tie isté operácie, ktoré vykonáva človek v ovládacom paneli. Pripojte ho z Claude Code, Cursor, Windsurf alebo hociktorého klienta kompatibilného s MCP.
Môžem to použiť pre backendové reťazce a e-maily?
Áno. SDK Node.js, Ruby on Rails, Python a Go bežia na serveri. Preložte predmet e-mailu, chybovú správu alebo pushové oznámenie rovnakým spôsobom ako prekladáte reťazec používateľského rozhrania. Serverové SDK ukladajú preklady do pamäte a obnovujú ich na pozadí, takže nepridávajú oneskorenie k vašej požiadavke.
Môže celý môj tím pracovať na prekladoch?
Áno. Pridajte členov tímu do projektu z ovládacieho panelu alebo cez API. Každý člen môže vidieť všetky preklady, prepísať ľubovoľnú hodnotu a pridať jazyky. Administrátori vytvárajú projekty a spravujú členov. Nie je nastavené cenové ohodnotenie za miesto: pridajte toľko ľudí, koľko potrebujete.
Ako môžem opravni preklep?
Zdrojový text je kľúč. Ak opravíte preklep v zdrojovom texte, dostanete nový kľúč s novým prekladom; starý reťazec sa už nevyžaduje a dashboard ho automaticky vyčistí po 30 dňoch nečinnosti. Preklep v preklade: upravte bunku v dashboardi a oprava bude trvalá.
Prečítajte si celú odpoveď s kódom