Často kladené dotazy
Vše, co potřebujete vědět o i18n-keyless, než začnete.
Musím spravovat soubory s překlady?
Ne. Neexistují žádné JSON soubory, žádný krok extrakce klíčů ani žádný plugin pro sestavení. Napište své věty ve zdrojovém jazyce, SDK je odešle na API v prvním požadavku, API je přeloží pomocí AI a každý následující požadavek je obsloužen z cache. Váš kód je jediným zdrojem pravdy.
Co se stane, když změníme zdrojový text?
Zdrojový text je klíč. Pokud jej změníte, získáte nový klíč s novým AI překladem. Starý klíč přestane být požadován a řídicí panel jej po 30 dnech nečinnosti odstraní. Oprava překlepu funguje stejně: opravte ji v kódu, nasaďte a nový text bude přeložen při prvním požadavku.
Kolik to stojí?
Samostatně hostováno: zcela zdarma, neomezený počet projektů, bez předplatného a bez limitu používání — nainstalujte si Docker image a použijte svůj vlastní AI klíč. Líbí se vám to? Dejte mi tip! Hostováno: pevná měsíční cena za projekt podle aktivních uživatelů — 4 € do 1 000, 9 € do 5 000, 29 € do 50 000, 99 € do 500 000 — fakturováno měsíčně, můžete kdykoli zrušit. V obou případech není žádné cenové určení podle počtu míst, slov či řetězců.
Mohu exportovat své překlady?
Ano. Řídicí panel má tlačítko „Exportovat JSON“, které stáhne všechny překlady ve vašem projektu jako jeden soubor JSON. Export zahrnuje všechny řádky, nejen ty použité v posledních 30 dnech, takže jde o úplnou zálohu. Neexistuje žádné omezení: vaše data jsou vždy jen jeden klik daleko.
Jaké frameworky podporuje?
React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift a Kotlin. Všechny SDK fungují stejným způsobem: zabalte svůj text do volání překladu a API vrátí překlad pro aktuální jazyk. Serverové SDK jsou thread-safe a ukládají překlady do paměti.
Kolik jazyků je podporováno?
48 jazyků, včetně regionálních variant jako zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR a es / es-MX. Arabština, hebrejština a urdština jsou také v seznamu, takže jazyky psané zprava doleva fungují také. Přidání nového jazyka do vašeho projektu je pouhým kliknutím v řídicím panelu.
Funguje to s renderováním na straně serveru?
Ano. Node.js SDK používá AsyncLocalStorage, takže vaše loadery, head funkce a serverové komponenty mohou překládat bez poskytovatele Reactu. Na straně klienta poskytovatel Reactu hydratuje z HTML vykresleného na serveru. V dokumentaci jsou k dispozici podrobné průvodce pro Next.js, Nuxt a TanStack Start.
Zpomaluje to mou aplikaci?
Pokaždé, když je požadován nový řetězec poprvé, API zavolá AI model — asi půl sekundy pro krátký řetězec UI, déle pro odstavec. Všechny následující požadavky jsou obsluhovány z databáze, což je běžný cache hit. SDK také ukládá překlady do místní paměti, takže vracející se uživatelé nepozorují žádné zpoždění sítě. Pokud deset uživatelů požádá o stejný řetězec současně, provede se pouze jedno volání AI.
Co se stane, když služba přestane fungovat?
Každý SDK ukládá překlady do mezipaměti lokálně — v localStorage na webu, v AsyncStorage v mobilních zařízeních a v paměti na serveru. Pokud není API dostupné, SDK poskytuje uložené překlady. Vaši uživatelé vidí poslední známý překlad, nikdy prázdný řetězec. Když se API obnoví, SDK se tiše obnoví.
Kterého poskytovatele AI používá?
Je podporováno pět poskytovatelů: Mistral, OpenAI, Anthropic, Google a jakýkoli endpoint kompatibilní s OpenAI, jako je Ollama, Groq nebo Together. Operátor vybere poskytovatele a model z řídicího panelu nebo z prostředí. Výchozí nastavení na i18n-keyless.com je Mistral. Uživatelé, kteří si službu hostují sami, mohou spustit Ollama lokálně a nic neposílat třetí straně.
Mohu přepsat překlad AI?
Ano. Klikněte na libovolnou buňku v řídicím panelu, zadejte správný text a uložte. Oprava je trvalá: rozhraní API nikdy nepřepíše hodnotu, kterou jste nastavili ručně. Můžete také přepsat překlady prostřednictvím rozhraní API nebo prostřednictvím serveru MCP, takže vám je může opravit i AI kódovací agent.
Mohu migrovat z i18next nebo z jiné knihovny?
Ano. V dokumentaci je k dispozici průvodce krok po kroku pro migraci pro i18next, react-intl a Lokalise. API má koncový bod pro migraci, který importuje vaše stávající překlady jeden po druhém, bez jakéhokoli volání AI a bez jakéhokoli účtování. MCP server má stejný nástroj, takže AI agent může provést migraci za vás.
Je zde nějaký bezplatný plán?
Samostatně hostěná verze je zcela zdarma s neomezeným počtem projektů — nainstalujte si Docker image, použijte svůj vlastní AI klíč a uchovávejte svá data na vlastním serveru. Žádné časové omezení, žádná omezení funkcí. Hostovaná verze začíná na 4 eurech měsíčně za projekt, pokud nechcete spouštět server.
Je zdrojový kód k dispozici?
Server, dashboard a Docker image jsou zveřejněny na GitHubu pod licencí Elastic 2.0. Můžete si přečíst každý řádek, spustit kód a změnit ho. SDK — React, Vue, Node, Rails a další — jsou licencovány pod MIT. Jediné omezení: nesmíte poskytovat software jako hostovanou službu třetím stranám.
Jeden správce: co se stane, když se projekt zastaví?
SDK jsou pod MIT licencí a zůstávají dostupné na npm, PyPI, RubyGems a dalších registrech. Server je veřejný pod Elastic Licencí 2.0 a protokol mezi nimi je zdokumentován, takže jej může kdokoli spustit, vytvořit jeho fork nebo napsat proti němu server. Vaše překlady zůstávají v jednom JSON exportu kdykoli. Pokud hostovaná služba přestane fungovat: nainstalované aplikace pokračují ve službě svých uložených překladů, nový klient se vrací k výchozímu jazyku a nasměrováním SDK na vlastní instanci s API_URL se vše obnoví. Co byste ztratili, je AI překlad nových řetězců na i18n-keyless.com — nikoli vaše data ani aplikaci.
Přečtěte si celou odpověď včetně kóduNení kontext jen klíč v přestrojení?
Ne. Klíč je povinný pro každý řetězec, musí být jedinečný a nachází se ve globálním jmenném prostoru, který udržujete ručně. Kontext je volitelný a je připojen pouze k několika málo řetězcům, jejichž význam je nejasný — např. "Close" pro zavření okna nebo "close" ve smyslu vzdálenosti — a popisuje význam, nikoli název řetězce. Většina řetězců žádný kontext nemá. Zdrojový text slouží jako reference, ať už je kontext přítomen či nikoli; dva identické texty s dvěma různými kontexty jsou prostě dva řádky.
Přečtěte si celou odpověď včetně kóduMohu zkontrolovat kopii v pull requestu?
Ano. Zdrojový řetězec je v kódu, takže každá změna znění představuje rozdíl, který recenzent čte v pull requestu v běžném jazyce místo názvu klíče. To, co není v gitu, je překlad do ostatních jazyků: ten je uložen v databázi, stejně jako u jakékoli jiné překladové platformy, a prohlížíte si ho v nástěnce, kde značka "zpracováno" pro každou buňku odděluje to, co zkontroloval člověk, od toho, co napsala AI, případně v exportu JSON.
Přečtěte si celou odpověď včetně kóduProč ne Tolgee, které je také open source?
Tolgee je platforma pro překlady založená na klíčích pod licencí Apache 2.0, s úpravami v kontextu, kontextem snímků obrazovky a pamětí překladů; pokud tyto funkce chcete, nebo překladatele zapojené do procesu, je to dobrá volba. i18n-keyless nemá klíče, žádné konfigurační soubory lokalizace, AI překlad je výchozí s ručním přepsáním, které AI nikdy nepřepisuje, server pod Elastic licencí 2.0 s MIT SDK a samohostovaný obraz, který běží na SQLite v jednom kontejneru. Pro opravu v kontextu pořídíte snímek obrazovky a pošlete ho AI agentovi připojenému k MCP serveru: ten najde řetězec a přepíše překlad. Stránka srovnání v dokumentaci zobrazuje ceny vedle sebe.
Přečtěte si celou odpověď včetně kóduSamoobsluha nebo předplatné: které z nich?
Samostatně hostované: stejný Docker obraz na vašem vlastním serveru, zcela zdarma s neomezeným počtem projektů, s vlastním AI klíčem a vašimi daty doma. Líbí se vám to? Dejte mi spropitné! Předplatné: my to spravujeme, aktualizace jsou automatické, pevná cena 4 € měsíčně za projekt. Vyberte si předplatné, pokud nechcete spravovat server.
Přečtěte si celou odpověď včetně kóduJak mohu pracovat s dynamickými hodnotami, jako jsou jména nebo počty?
Použijte možnost nahrazení. Napište větu s zástupným symbolem — „Ahoj {name}, máte {count} položek“ — a při vykreslování předávejte hodnoty pomocí replace: { "{name}": userName, "{count}": String(n) }. Umělá inteligence vidí zástupný symbol a ponechá ho v každém překladu. SDK hodnotu nahradí během runtime.
Jak pracuji s množným číslem?
Napište jeden tvar s {count}, kde číslo jde, a předávejte ho jako count. API ukládá jednu zprávu ICU pro množné číslo pro každý jazyk s přesně takovými tvary, které jazyk potřebuje — dvě ve francouzštině, čtyři v ruštině, šest v arabštině — ověřené proti Intl.PluralRules, a SDK vybere tu správnou. Přidejte řadovou číslovku pro pořadí (1st, 2nd). Nikdy sami nevytváříte větve.
Přečtěte si celou odpověď včetně kóduJak zacházím s pohlavími?
Předávejte hodnotu v select — select={{ gender: "žena" }} — a model píše jednu variantu pro každou hodnotu, ve všech jazycích, s ohledem na jazykové potřeby. Hodnoty jsou identifikátory z uzavřené množiny, maximálně 10 na proměnnou a 2 proměnné na větu; lze kombinovat select a count. Otevřené hodnoty, jako je jméno, zůstávají nahrazením.
Přečtěte si celou odpověď včetně kóduJak formátovat data, čísla a měny?
SDK je neformátuje, to dělá váš runtime. Použijte Intl.DateTimeFormat a Intl.NumberFormat s aktuálním jazykem ze SDK a poté vložte výsledek do věty pomocí replace. Jedna věta, jeden překlad, správný formát v každém jazyce.
Přečtěte si celou odpověď včetně kóduMohu přizpůsobit výzvu pro překlad?
Ne, a ani to nemusíte dělat. Výzva čte váš kontext pro každý klíč: tam se určuje tón, publikum a význam, a právě to způsobuje, že se stejné slovo na dvou místech překládá odlišně. A jakýkoli překlad lze ručně přepsat v řídicím panelu; API nikdy nepřepíše to, co jste napsali.
Přečtěte si celou odpověď včetně kóduMá to MCP server pro AI kódovací agenty?
Ano. API je také MCP server s autentizací OAuth 2.1. AI agent může vypsat překlady, překládat řetězce, přepsat hodnoty, importovat existující překlady a spravovat členy projektu — stejné operace, které provádí člověk v ovládacím panelu. Připojte jej z Claude Code, Cursor, Windsurf nebo jakéhokoli klienta kompatibilního s MCP.
Mohu to použít pro backendové řetězce a e-maily?
Ano. Node.js, Ruby on Rails, Python a Go SDK běží na serveru. Přeložte předmět e-mailu, chybovou zprávu nebo push notifikaci stejným způsobem jako řetězec uživatelského rozhraní. Serverové SDK ukládají překlady do paměti a obnovují je na pozadí, takže nepřidávají latenci k vaší žádosti.
Může celý můj tým pracovat na překladech?
Ano. Přidejte členy týmu do projektu z řídicího panelu nebo prostřednictvím API. Každý člen může vidět všechny překlady, přepsat libovolnou hodnotu a přidat jazyky. Správci vytvářejí projekty a spravují členy. Neexistuje cenové ohodnocení za místo: přidejte tolik členů, kolik potřebujete.
Jak mohu opravit překlep?
Zdrojový text je klíč. Opravíte-li překlep ve zdrojovém textu, získáte nový klíč s novým překladem; starý řetězec se přestane vyžadovat a řídicí panel jej po 30 dnech nečinnosti automaticky odstraní. Překlep v překladu: upravte buňku v řídicím panelu a oprava bude trvalá.
Přečtěte si celou odpověď včetně kódu