Usein kysytyt kysymykset

Kaikki mitä sinun tarvitsee tietää i18n-keylessistä ennen kuin aloitat.

Täytyykö minun hallinnoida käännöstiedostoja?

Ei. JSON-tiedostoja ei ole, avainten poimintavaihetta ei ole eikä rakennusaikaisia liitännäisiä ole. Kirjoitat lauseesi lähdekielellä, SDK lähettää ne API:lle ensimmäisellä pyynnöllä, API kääntää ne tekoälyllä ja jokainen seuraava pyyntö palvellaan välimuistista. Koodisi on ainoa totuuden lähde.

Mitä tapahtuu, kun muutan lähdetekstiä?

Lähdeteksti on avain. Muutamalla sitä saat uuden avaimen, jossa on tuore AI-käännös. Vanha avain lakkaa yksinkertaisesti olemasta pyydetty, ja kojelauta poistaa sen käytön jälkeen 30 päivän kuluttua. Myös kirjoitusvirheen korjaus toimii samalla tavalla: korjaa se koodissa, julkaise, ja uusi teksti käännetään ensimmäisellä pyynnöllä.

Paljonko se maksaa?

Itse isännöity: täysin ilmainen, rajoittamattomat projektit, ei tilausta eikä käyttörajoituksia — asenna Docker-kuva, käytä omaa AI-avaintasi. Pidätkö siitä? Anna minulle vinkki! Isännöity: kiinteä kuukausihinta per projekti, kuukausittain aktiivisten käyttäjien mukaan — 4 € asti 1 000, 9 € asti 5 000, 29 € asti 50 000, 99 € asti 500 000 — laskutetaan kuukausittain, voit perua milloin tahansa. Ei hinnoittelua per paikka, per sana tai per merkkijono kummassakaan tapauksessa.

Voinko viedä käännökseni?

Kyllä. Ohjauspaneelissa on "Vie JSON" -painike, joka lataa projektisi kaikki käännökset yhdeksi JSON-tiedostoksi. Vie-toiminto sisältää kaikki rivit, ei vain viimeisen 30 päivän aikana käytetyt, joten se on täysi varmuuskopio. Ei lukitusta: datasi on aina vain yhden klikin päässä.

Mitä kehikoita se tukee?

React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift ja Kotlin. Jokainen SDK toimii samalla tavalla: kääri tekstisi käännöskutsun sisään, ja API palauttaa käännöksen nykyiselle kielelle. Palvelimen SDK:t ovat säikeisturvallisia ja välimuistittavat muistiin.

Kuinka monta kieltä tuetaan?

48 kieltä, mukaan lukien alueelliset variantit kuten zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR ja es / es-MX. Arabialainen, heprea ja urdu ovat myös listalla, joten oikealta vasemmalle kirjoitettavat kielet toimivat myös. Uuden kielen lisääminen projektiisi on yhden klikin päässä kojelaudasta.

Toimiiko se palvelinpuolen renderöinnin kanssa?

Kyllä. Node.js SDK käyttää AsyncLocalStorageia, jotta lataajasi, head-toiminnot ja palvelinkomponentit voivat kääntää ilman React-tarjoajaa. Asiakassivulla React-tarjoaja hydratoi palvelimella renderöidystä HTML:stä. Dokumentaatiossa on vaiheittainen opas Next.js:lle, Nuxtille ja TanStack Startille.

Hidastaako se sovellustani?

Ensimmäisen kerran, kun uutta merkkijonoa pyydetään, API kutsuu tekoälymallia — noin puoli sekuntia lyhyelle käyttöliittymämerkkijonolle, pidempään kappaleelle. Kaikki myöhemmät pyynnöt palveltaan tietokannasta, mikä on tavallinen välimuistihit. SDK myös tallentaa käännökset paikallisesti, joten palaavat käyttäjät eivät näe minkäänlaista verkkoviivettä. Jos kymmenen käyttäjää pyytää samaa merkkijonoa samanaikaisesti, tehdään vain yksi tekoälykutsutus.

Mitä tapahtuu, jos palvelu lakkaa toimimasta?

Jokainen SDK tallentaa käännökset paikallisesti — localStorageiin verkkosivulla, AsyncStorageiin mobiililaitteessa ja muistiin palvelimella. Jos API:ta ei päästä käsiksi, SDK tarjoaa välimuistiin tallennetut käännökset. Käyttäjät näkevät viimeisimmän tunnetun käännöksen, ei koskaan tyhjää merkkijonoa. Kun API on taas käytettävissä, SDK päivittää hiljaisesti.

Mitä AI-palveluntarjoajaa se käyttää?

Viisi palveluntarjoajaa on tuettu: Mistral, OpenAI, Anthropic, Google sekä mikä tahansa OpenAI-yhteensopiva päätepiste, kuten Ollama, Groq tai Together. Operaattori valitsee palveluntarjoajan ja mallin kojelaudalta tai ympäristöstä. Oletusasetus i18n-keyless.com:ssa on Mistral. Itse isännöidyt käyttäjät voivat ajaa Ollaman paikallisesti eivätkä lähetä mitään kolmansille osapuolille.

Voinko ohittaa tekoälykäännöksen?

Kyllä. Napsauta ohjauspaneelin mitä tahansa solua, kirjoita oikea teksti ja tallenna. Korjaus on pysyvä: API ei koskaan kirjoita yli manuaalisesti asetettua arvoa. Voit myös ohittaa käännökset API:n tai MCP-palvelimen kautta, joten tekoälykoodausagentti voi korjata käännöksen puolestasi.

Voinko siirtyä i18nextistä tai toisesta kirjastosta?

Kyllä. Dokumentaatiossa on vaiheittainen migraatio-opas i18next:lle, react-intl:lle ja Lokaliselle. API:ssa on migraatio-päätepiste, joka tuo vanhat käännöksesi yksi kerrallaan ilman AI-kutsuja tai laskutusta. MCP-palvelimella on sama työkalu, joten tekoälyagentti voi tehdä migraation puolestasi.

Onko ilmainen suunnitelma?

Itse isännöity versio on täysin ilmainen rajoittamattomien projektien kanssa — asenna Docker-kuva, käytä omaa AI-avaintasi ja pidä tietosi omalla palvelimellasi. Ei aikarajoitusta, ei ominaisuusrajoituksia. Pilvipalvelun versio alkaa 4 eurolla kuukaudessa per projekti, jos et halua ylläpitää palvelinta itse.

Onko lähdekoodi saatavilla?

Palvelin, kojelauta ja Docker-kuva on julkaistu GitHubissa Elastic License 2.0 -lisenssillä. Voit lukea jokaista riviä, ajaa koodin ja muuttaa sitä. SDK:t — React, Vue, Node, Rails ja muut — ovat MIT-lisenssillä. Ainoa rajoitus: et saa tarjota ohjelmistoa isännöitynä palveluna kolmansille osapuolille.

Yksi ylläpitäjä: mitä tapahtuu, jos projekti pysähtyy?

SDK:t ovat MIT-lisenssillä ja pysyvät saatavilla npm:ssä, PyPI:ssä, RubyGemsissä ja muissa rekistereissä. Palvelin on julkinen Elastic License 2.0:n alaisuudessa, ja niiden välinen protokolla on dokumentoitu, joten kuka tahansa voi ajaa sen, forkata sen tai kirjoittaa sitä vastaan palvelimen. Käännöksesi pysyvät yhdessä JSON-viennissä milloin tahansa. Jos isännöity palvelu lakkaa toimimasta: asennetut sovellukset jatkavat välimuistissa olevien käännösten tarjoamista, uusi asiakasohjelma palaa lähdekieleen, ja SDK:n osoittaminen omalle instanssillesi API_URL:n avulla palauttaa kaiken. Menettäisit vain i18n-keyless.com-sivuston uusien merkkijonojen tekoälykäännöksen — ei tietojasi eikä sovellustasi.

Lue koko vastaus koodineen
Eikö konteksti ole vain naamioitunut avain?

Ei. Jokaisella merkkijonolla on oltava avain, jonka täytyy olla yksilöllinen ja joka sijaitsee globaalissa nimistössä, jota ylläpidät manuaalisesti. Konteksti on valinnainen ja liittyy vain harvoihin merkitykseltään epäselviin merkkijonoihin — esimerkiksi "Close" ikkunan sulkemiseen tai "close" läheisyyden merkityksessä — ja se kuvaa merkitystä, mutta ei nimeä merkkijonoa. Useimmilla merkkijonoilla ei ole kontekstia. Lähdeteksti toimii hakuviitteenä, kontekstista riippumatta; kaksi identtistä tekstiä kahdella eri kontekstilla ovat yksinkertaisesti kaksi riviä.

Lue koko vastaus koodineen
Voinko tarkistaa kopion pull requestissa?

Kyllä. Lähdestringsi on koodissa, joten jokainen sanamuutoksen ero on jotain, mitä tarkastaja lukee pull requestissa selkeällä kielellä avaimen nimen sijaan. Gitissä ei ole muiden kielten käännöksiä: ne sijaitsevat tietokannassa, kuten missä tahansa käännösalustassa, ja voit tarkastella niitä kojelaudassa, jossa jokaisessa solussa oleva "tarkastettu"-merkintä erottaa ihmisen tarkastaman sisällön AI:n kirjoittamasta, tai JSON-viennissä.

Lue koko vastaus koodineen
Miksi ei Tolgee, joka on myös avoimen lähdekoodin?

Tolgee on avainpohjainen käännösalusta Apache 2.0 -lisenssin alaisena, joka tarjoaa kontekstieditoinnin, kuvakaappauskontekstin ja käännöksen muistin; jos haluat nämä ominaisuudet tai kääntäjiä osana prosessia, se on hyvä valinta. i18n-keylessillä ei ole avaimia, ei lokalisointitiedostoja, AI-käännös on oletusarvoisesti käytössä manuaalisella ylikirjoituksella, jota tekoäly ei koskaan muokkaa uudelleen, palvelin Elastic License 2.0:n alaisuudessa MIT SDK:ien kanssa sekä itseisännöity kuvatiedosto, joka toimii SQLite:llä yhdessä kontissa. Kontekstikorjauksen vuoksi ota kuvakaappaus ja anna se MCP-palvelimeen yhdistetylle tekoälyagentille: se löytää merkkijonon ja ylikirjoittaa käännöksen. Dokumentaation vertailusivulla hinnat esitetään rinnakkain.

Lue koko vastaus koodineen
Itse isännöity vai tilaus: kumpi?

Itse isännöity: sama Docker-kuva omalla palvelimellasi, täysin ilmainen rajoittamattomilla projekteilla, omalla AI-avaimellasi ja tiedoillasi kotona. Pidätkö siitä? Anna minulle vinkki! Tilaaminen: me hoidamme sen, päivitykset ovat automaattisia, kiinteä hinta 4 €/kk per projekti. Valitse tilaus, jos et halua ylläpitää palvelinta itse.

Lue koko vastaus koodineen
Kuinka käsittelen dynaamisia arvoja, kuten nimiä tai laskureita?

Käytä korvausasetusta. Kirjoita lause paikkamerkillä — "Hei {name}, sinulla on {count} kohdetta" — ja anna arvot renderöinnin yhteydessä replace:llä: { "{name}": userName, "{count}": String(n) }. Tekoäly havaitsee paikkamerkin ja säilyttää sen jokaisessa käännöksessä. SDK korvaa arvon suoritusaikana.

Kuinka käsittelen monikkomuotoja?

Kirjoita yksi muoto, jossa {count} korvataan numerolla ja välitä numero count-parametrina. API tallentaa yhden ICU-monikkomuotoisen viestin per kieli tarkasti tarvittavine muotoineen — kaksi ranskaksi, neljä venäjäksi, kuusi arabiaksi — tarkistettuna Intl.PluralRules:n avulla, ja SDK valitsee oikean. Lisää järjestysluvut sijoituksia varten (1st, 2nd). Et koskaan kirjoita haaroja itse.

Lue koko vastaus koodineen
Kuinka käsittelen sukupuolia?

Anna arvo select-muuttujaan — select={{ gender: "nainen" }} — ja malli kirjoittaa yhden variantin jokaista arvoa kohden, jokaiseen kieleen, huomioiden kielen tarpeet. Arvot ovat tunnisteita suljetusta joukosta, enintään 10 per muuttuja ja 2 muuttujaa per lause; select ja count voidaan yhdistää. Avoimet arvot, kuten nimi, pysyvät korvauksena.

Lue koko vastaus koodineen
Kuinka muotoilen päivämäärät, numerot ja valuutat?

SDK ei muodosta niitä, sen tekee ajonaikasi. Käytä Intl.DateTimeFormat- ja Intl.NumberFormat-työkaluja SDK:n nykyisellä kielellä ja sijoita tulos sitten lauseeseen replace-toiminnolla. Yksi lause, yksi käännös, oikea muoto jokaisessa kielessä.

Lue koko vastaus koodineen
Voinko muokata käännöksen kehotteita?

Ei, eikä sinun tarvitse tehdä sitä. Kehote lukee kontekstisi jokaiselle avaimelle: siinä määritellään sävy, yleisö ja merkitys, ja juuri se saa saman sanan kääntymään eri tavoin kahdessa eri paikassa. Ja minkä tahansa käännöksen voi ohittaa manuaalisesti kojelaudassa; API ei koskaan kirjoita yli sitä, mitä olet kirjoittanut.

Lue koko vastaus koodineen
Onko sillä MCP-palvelin AI-koodausagentteja varten?

Kyllä. API on myös MCP-palvelin OAuth 2.1 -todennuksella. AI-agentti voi listata käännökset, kääntää merkkijonoja, korvata arvot, tuoda olemassa olevia käännöksiä ja hallita projektin jäseniä — samat toiminnot, joita ihminen tekee hallintapaneelissa. Yhdistä se Claude Codeen, Cursoriin, Windsurfiin tai mihin tahansa MCP-yhteensopivaan asiakasohjelmaan.

Voinko käyttää sitä backend-merkkijonoihin ja sähköposteihin?

Kyllä. Node.js-, Ruby on Rails-, Python- ja Go-SDK:t toimivat palvelimella. Käännä sähköpostin aihe, virheilmoitus tai push-ilmoitus samalla tavalla kuin käännät käyttöliittymämerkkijonon. Palvelimen SDK:t tallentavat käännökset muistiin ja päivittävät ne taustalla, joten ne eivät lisää viivettä pyyntöösi.

Voiko koko tiimimme työskennellä käännöksissä?

Kyllä. Lisää tiimin jäsenet projektiin kojelaudalta tai API:n kautta. Jokainen jäsen voi nähdä kaikki käännökset, korvata minkä tahansa arvon ja lisätä kieliä. Ylläpitäjät luovat projekteja ja hallinnoivat jäseniä. Ei istumapaikkakohtaista hinnoittelua: lisää niin monta henkilöä kuin tarvitset.

Kuinka korjaan kirjoitusvirheen?

Lähdeteksti on avain. Jos korjaat lähdetekstin kirjoitusvirheen, saat uuden avaimen uuden käännöksen kanssa; vanha merkkijono ei enää kysytä, ja kojelauta poistaa sen itsenäisesti 30 päivän käyttämättömyyden jälkeen. Käännöksen kirjoitusvirhe: muokkaa solua kojelaudassa, ja korjaus on pysyvä.

Lue koko vastaus koodineen