Često postavljana pitanja
Sve što trebate znati o i18n-keyless prije nego što počnete.
Treba li mi upravljati datoteke prijevoda?
Ne. Nema JSON datoteka, nema koraka za izdvajanje ključeva, niti dodatka za vrijeme izgradnje. Pišete svoje rečenice na izvornom jeziku, SDK ih šalje API-ju na prvom zahtjevu, API ih prevodi pomoću AI-ja, a svaki sljedeći zahtjev se opslužuje iz predmemorije. Vaš kod je jedini izvor istine.
Što se događa kada promijenim izvorni tekst?
Izvorni tekst je ključ. Promijenite ga i dobit ćete novi ključ s novim AI prijevodom. Stari ključ jednostavno prestaje biti zatražen, a nadzorna ploča ga nakon 30 dana neaktivnosti očisti. Ispravljanje tipfelerke radi se na isti način: ispravite je u kodu, objavite i novi tekst će biti preveden na prvom zahtjevu.
Koliko to košta?
Samostalno hostirano: potpuno besplatno, neograničeni projekti, bez pretplate i bez ograničenja korištenja — instalirajte Docker sliku, koristite vlastiti AI ključ. Sviđa vam se? Podržite me! Hostirano: fiksna cijena po projektu mjesečno, prema aktivnim korisnicima mjesečno — 4 € do 1.000, 9 € do 5.000, 29 € do 50.000, 99 € do 500.000 — naplaćuje se mjesečno, možete otkazati u bilo kojem trenutku. Nema cijene po sjedištu, po riječi ili po stringu u oba slučaja.
Mogu li izvesti svoje prijevode?
Da. Nadzorna ploča ima gumb "Izvezi JSON" koji preuzima sve prijevode u vašem projektu kao jednu JSON datoteku. Izvoz uključuje sve retke, ne samo one koji su korišteni u posljednjih 30 dana, pa je to potpuna sigurnosna kopija. Nema zaključavanja: vaši podaci uvijek su samo jedan klik udaljeni.
Koje okvire podržava?
React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift i Kotlin. Svi SDK-ovi rade na isti način: omotajte svoj tekst u poziv za prijevod, a API vraća prijevod za trenutni jezik. Server SDK-ovi su sigurni za rad s nitima i keširaju prijevode u memoriji.
Koliko jezika je podržano?
48 jezika, uključujući regionalne varijante poput zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR i es / es-MX. Arapski, hebrejski i urdu također su na popisu, pa rade i jezici koji se pišu s desna na lijevo. Dodavanje novog jezika u svoj projekt je samo jedan klik u nadzornoj ploči.
Radi li to s renderiranjem na strani poslužitelja?
Da. Node.js SDK koristi AsyncLocalStorage, tako da vaši učitivači, head funkcije i serverski komponenti mogu prevoditi bez React pružatelja. Na strani klijenta, React pružatelj hidrira iz HTML-a koji je renderiran na serveru. U dokumentaciji postoje vodiči korak po korak za Next.js, Nuxt i TanStack Start.
Usporava li to moju aplikaciju?
Prvi put kada se zatraži novi niz, API poziva AI model — oko pola sekunde za kratki UI niz, više za odlomak. Svaki sljedeći zahtjev se opslužuje iz baze podataka, što je uobičajeni cache hit. SDK također lokalno kešira prijevode, pa korisnici koji se vraćaju ne vide nikakvo kašnjenje mreže. Ako deset korisnika zatraži isti niz u isto vrijeme, napravi se samo jedan AI poziv.
Što se dogodi ako usluga padne?
Svaki SDK kešira prijevode lokalno — u localStorage na webu, AsyncStorage na mobilnim uređajima i u memoriji na poslužitelju. Ako API nije dostupan, SDK služi keširane prijevode. Vaši korisnici vide zadnju poznatu prijevode, nikad prazan string. Kada se API vrati, SDK se tiho osvježava.
Koji AI pružatelj usluga koristi?
Podržana su pet pružatelja usluga: Mistral, OpenAI, Anthropic, Google i bilo koja OpenAI-kompatibilna krajnja točka poput Ollama, Groq ili Together. Operator bira pružatelja i model s nadzorne ploče ili iz okruženja. Zadana postavka na i18n-keyless.com je Mistral. Korisnici koji sami hostaju mogu pokrenuti Ollama lokalno i ništa ne šalju trećoj strani.
Mogu li nadjačati AI prijevod?
Da. Kliknite na bilo koju ćeliju u nadzornoj ploči, upišite točan tekst i spremite. Ispravak je trajan: API nikada ne prepisuje vrijednost koju ste ručno postavili. Također možete nadjačati prijevode putem API-ja ili putem MCP poslužitelja, pa AI kodni agent može ispraviti prijevod za vas.
Mogu li migrirati iz i18next ili druge knjižnice?
Da. U dokumentaciji postoji vodič za postupnu migraciju za i18next, react-intl i Lokalise. API ima krajnju točku za migraciju koja uvozi vaše postojeće prijevode jedan po jedan, bez ikakvog poziva AI-ja i bez naplate. MCP poslužitelj ima isti alat, pa AI agent može obaviti migraciju umjesto vas.
Ima li besplani plan?
Samodomaćna inačica potpuno je besplatna s neograničenim projektima — instalirajte Docker sliku, koristite vlastiti AI ključ i držite svoje podatke na vlastitom poslužitelju. Nema vremenskog ograničenja, niti ograničenja značajki. Hostirana inačica počinje od 4 eura mjesečno po projektu ako radije ne želite pokretati poslužitelj.
Je li izvorni kod dostupan?
Poslužitelj, nadzorna ploča i Docker slika objavljeni su na GitHubu pod Elastic licencom 2.0. Možete pročitati svaki redak, izvoditi kod i mijenjati ga. SDK-ovi — React, Vue, Node, Rails i drugi — licencirani su pod MIT licencom. Jedino ograničenje: ne smijete ponuditi softver kao uslugu hostanu trećim stranama.
Jedan održavatelj: što se dogodi ako se projekt zaustavi?
SDK-ovi su pod MIT licencom i ostaju dostupni na npm-u, PyPI-ju, RubyGemsima i drugim registrima. Server je javno dostupan pod Elastic Licencom 2.0, a protokol između njih je dokumentiran, tako da ga može pokrenuti, forkati ili napisati server protiv njega bilo tko. Vaši prijevodi ostaju u jednom JSON exportu u bilo kojem trenutku. Ako hostana usluga prestane raditi: instalirane aplikacije nastavljaju servirati svoje keširane prijevode, novi klijent se vraća na izvorni jezik, a usmjeravanjem SDK-a na vlastitu instancu s API_URL-om sve se vraća u normalu. Ono što biste izgubili jest AI prijevod novih stringova na i18n-keyless.com — ne vaše podatke niti aplikaciju.
Pročitajte potpuni odgovor s kodomZar je kontekst samo ključ u maskiranju?
Ne. Ključ je obavezan za svaki string, mora biti jedinstven i nalazi se u globalnom prostoru imena koji održavate ručno. Kontekst je opcionalan, vezan uz nekoliko stringova kojima je značenje nejasno — npr. "Close" za zatvaranje prozora ili "close" za udaljenost — i opisuje značenje, ne naziva string. Većina stringova nema kontekst. Izvorni tekst služi kao referenca, s ili bez konteksta; dva identična teksta s dva različita konteksta su jednostavno dva retka.
Pročitajte potpuni odgovor s kodomMogu li pregledati kopiju u pull requestu?
Da. Izvorni niz nalazi se u kodu, pa je svaka promjena teksta razlika koju recenzent čita u pull requestu, u običnom jeziku umjesto naziva ključa. Ono što nije u git repozitoriju su prijevodi na druge jezike: oni se nalaze u bazi podataka, kao i kod bilo koje druge platforme za prijevode, te ih pregledate u nadzornoj ploči gdje oznaka "pregledano" po ćeliji odvaja ono što je provjerio čovjek od onoga što je napisala AI, ili u JSON izvozu.
Pročitajte potpuni odgovor s kodomZašto ne Tolgee, koji je također open source?
Tolgee je platforma za prijevod temeljena na ključevima pod licencom Apache 2.0, s uređivanjem u kontekstu, kontekstom snimaka zaslona i memorijom prijevoda; ako želite te mogućnosti ili prevoditelje u petlji, dobar je izbor. i18n-keyless nema ključeva, nema datoteka lokalizacije, AI prijevod je zadano s ručnim nadjačavanjem koje AI nikad ne prepravi, poslužitelj pod Elastic licencom 2.0 s MIT SDK-ovima te samostalno hostirana slika koja radi na SQLite u jednom spremniku. Za ispravak u kontekstu, snimite zaslon i proslijedite ga AI agentu povezanom s MCP poslužiteljem: on pronalazi niz i nadjačava prijevod. Stranica za usporedbu u dokumentaciji prikazuje cijene jednu do druge.
Pročitajte potpuni odgovor s kodomSamostalno hostiranje ili pretplata: koja od ove dvije?
Samodržan: isti Docker image na vašem vlastitom serveru, potpuno besplatno s neograničenim projektima, s vlastitim AI ključem i vašim podacima kod kuće. Sviđa vam se? Dajte mi napojnicu! Pretplata: mi to održavamo, ažuriranja su automatska, fiksna cijena od 4 eura mjesečno po projektu. Uzmi pretplatu ako ne želiš održavati server.
Pročitajte potpuni odgovor s kodomKako mogu rukovati dinamičkim vrijednostima poput imena ili brojeva?
Koristite opciju zamjene. Napišite rečenicu s mjestom za umetanje — "Bok {name}, imate {count} stavki" — i proslijedite vrijednosti u trenutku renderiranja s replace: { "{name}": userName, "{count}": String(n) }. Umjetna inteligencija vidi mjesto za umetanje i zadržava ga u svakom prijevodu. SDK zamjenjuje vrijednost tijekom izvođenja.
Kako se nosim s množinama?
Napišite jedan oblik s {count} gdje broj ide i proslijedite broj kao count. API pohranjuje jednu ICU poruku za množinu po jeziku s točno onoliko oblika koliko jezik treba — dva u francuskom, četiri u ruskom, šest u arapskom — provjeravajući protiv Intl.PluralRules, a SDK odabire odgovarajući. Dodajte redni broj za rangove (1st, 2nd). Nikada ne pišete grane sami.
Pročitajte potpuni odgovor s kodomKako se nositi s rodovima?
Prosljedite vrijednost u select — select={{ gender: "ženski" }} — a model piše jednu varijantu po vrijednosti, na svakom jeziku, uzimajući u obzir jezične potrebe. Vrijednosti su identifikatori iz zatvorenog skupa, najviše 10 po varijabli i 2 varijable po rečenici; select i count se mogu kombinirati. Otvorene vrijednosti poput imena ostaju zamjena.
Pročitajte potpuni odgovor s kodomKako formatiram datume, brojeve i valute?
SDK ih ne formatira, to radi vaš runtime. Koristite Intl.DateTimeFormat i Intl.NumberFormat s trenutnim jezikom iz SDK-a, zatim unesite rezultat u rečenicu s replace. Jedna rečenica, jedan prijevod, ispravan format na svakom jeziku.
Pročitajte potpuni odgovor s kodomMogu li prilagoditi poticaj za prijevod?
Ne, i ne morate to učiniti. Prompt čita vaš kontekst za svaki ključ: tu se definiraju ton, publika i značenje, i upravo to uzrokuje da se ista riječ prevede drugačije na dva mjesta. A svaki prijevod se može ručno nadjačati u nadzornoj ploči; API nikada ne prepisuje ono što ste napisali.
Pročitajte potpuni odgovor s kodomIma li MCP poslužitelj za AI kodne agente?
Da. API je također MCP poslužitelj s OAuth 2.1 autentifikacijom. AI agent može popisati prijevode, prevesti tekstove, nadjačati vrijednosti, uvesti postojeće prijevode i upravljati članovima projekta — iste radnje koje čovjek obavlja u nadzornoj ploči. Povežite ga s Claude Code, Cursor, Windsurf ili bilo kojim klijentom kompatibilnim s MCP.
Mogu li ga koristiti za backendove nizove i e-poruke?
Da. Node.js, Ruby on Rails, Python i Go SDK-ovi rade na poslužitelju. Prevedite naslov e-pošte, poruku o pogrešci ili push obavijest na isti način kao što prevodite niz korisničkog sučelja. SDK-ovi na poslužitelju keširaju prijevode u memoriji i osvježavaju ih u pozadini, pa ne dodaju latenciju vašem zahtjevu.
Može li moj cijeli tim raditi na prijevodima?
Da. Dodajte članove tima u projekt s nadzorne ploče ili putem API-ja. Svaki član može vidjeti sve prijevode, promijeniti bilo koju vrijednost i dodati jezike. Admini stvaraju projekte i upravljaju članovima. Nema cjenika po mjestu: dodajte koliko god članova vam treba.
Kako mogu ispraviti tipfeler?
Izvorni tekst je ključ. Ako ispravite tipkanu grešku u izvornom tekstu, dobit ćete novi ključ s novim prijevodom; stari se niz jednostavno više ne traži, a nadzorna ploča sama ga uklanja nakon 30 dana neuporabe. Tipkarska greška u prijevodu: uredite ćeliju u nadzornoj ploči, a ispravak će biti trajan.
Pročitajte potpuni odgovor s kodom