Întrebări frecvente

Tot ce trebuie să știți despre i18n-keyless înainte de a începe.

Trebuie să gestionez fișierele de traducere?

Nu. Nu există fișiere JSON, niciun pas de extragere a cheilor și niciun plugin de build-time. Scrieți propozițiile în limba sursă, SDK le trimite API-ului la prima cerere, API-ul le traduce cu AI, iar fiecare cerere ulterioară este servită din cache. Codul dvs. este singura sursă de adevăr.

Ce se întâmplă când schimb textul sursă?

Textul sursă este cheia. Dacă îl modificați, veți obține o nouă cheie cu o traducere AI proaspătă. Cheia veche pur și simplu nu mai este cerută, iar tabloul de bord o curăță după 30 de zile fără utilizare. Corectarea unei greșeli de tipar funcționează la fel: corectați-o în cod, implementați și noul text va fi tradus la prima cerere.

Cât costă?

Auto-gazduit: complet gratuit, proiecte nelimitate, fără abonament și fără limită de utilizare — instalați imaginea Docker, folosiți-vă propria cheie AI. Vă place? Dați-mi un sfat! Gazduit: un preț fix pe proiect pe lună, în funcție de utilizatorii activi lunar — 4 € până la 1.000, 9 € până la 5.000, 29 € până la 50.000, 99 € până la 500.000 — facturat lunar, poate fi anulat în orice moment. Nu există tarifare pe loc, pe cuvânt sau pe șir în niciunul dintre cazuri.

Pot să export traducerile mele?

Da. Panoul de control are un buton „Exportă JSON” care descarcă toate traducerile din proiectul tău ca un singur fișier JSON. Exportul include toate rândurile, nu doar cele folosite în ultimele 30 de zile, așa că este o copie de siguranță completă. Nu există niciun fel de restricție: datele tale sunt mereu la un clic distanță.

Ce framework-uri sunt suportate?

React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift și Kotlin. Fiecare SDK funcționează la fel: încapsulează textul într-un apel de traducere, iar API-ul returnează traducerea pentru limba curentă. SDK-urile serverului sunt thread-safe și memorează traducerile în memorie.

Câte limbi sunt suportate?

48 de limbi, inclusiv variante regionale precum zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR și es / es-MX. Limba arabă, ebraică și urdu sunt de asemenea pe listă, așa că limbile scrise de la dreapta la stânga funcționează și ele. Adăugarea unei noi limbi în proiectul tău este doar un clic în tabloul de bord.

Funcționează cu randarea pe partea de server?

Da. Node.js SDK utilizează AsyncLocalStorage, astfel încât încărcătoarele, funcțiile head și componentele serverului pot traduce fără un furnizor React. Pe partea clientului, furnizorul React hidratează din HTML-ul redat pe server. În documentație există ghiduri pas cu pas pentru Next.js, Nuxt și TanStack Start.

Aceasta încetinește aplicația mea?

Prima dată când este cerut un nou șir, API-ul apelează modelul AI — aproximativ o jumătate de secundă pentru un șir UI scurt, mai mult pentru un paragraf. Fiecare cerere ulterioară este servită din baza de date, care este o lovitură obișnuită a cache-ului. SDK-ul memorează și traducerile local, astfel încât utilizatorii care revin nu observă nicio întârziere a rețelei. Dacă zece utilizatori cer același șir în același timp, este făcută doar un apel către AI.

Ce se întâmplă dacă serviciul se oprește?

Fiecare SDK stochează traducerile local — în localStorage pe web, în AsyncStorage pe mobil și în memorie pe server. Dacă API-ul nu este accesibil, SDK-ul livrează traducerile stocate în cache. Utilizatorii tăi văd ultima traducere cunoscută, niciodată un șir gol. Când API-ul revine, SDK-ul se reîmprospătează în mod silențios.

Ce furnizor de AI folosește?

Sunt suportați cinci furnizori: Mistral, OpenAI, Anthropic, Google și orice punct final compatibil OpenAI, precum Ollama, Groq sau Together. Operatorul selectează furnizorul și modelul din tabloul de bord sau din mediul înconjurător. Implicit pe i18n-keyless.com este Mistral. Utilizatorii care se auto-găzduiesc pot rula Ollama local și nu trimit nimic către o terță parte.

Pot suprascrie o traducere AI?

Da. Faceți clic pe orice celulă din tabloul de bord, introduceți textul corect și salvați. Corecția este permanentă: API-ul nu suprascrie niciodată o valoare setată manual. De asemenea, puteți suprascrie traducerile prin API sau prin serverul MCP, astfel încât un agent de codificare AI să poată corecta o traducere pentru dvs.

Pot migra de la i18next sau o altă bibliotecă?

Da. În documentație există un ghid de migrare pas cu pas pentru i18next, react-intl și Lokalise. API-ul are un punct final de migrare care importă traducerile tale existente una câte una, fără apeluri AI sau facturare. Serverul MCP are același instrument, astfel încât un agent AI poate efectua migrarea pentru tine.

Există un plan gratuit?

Versiunea auto-gazduită este complet gratuită cu proiecte nelimitate — instalați imaginea Docker, folosiți-vă propria cheie AI și păstrați-vă datele pe propriul server. Fără limită de timp, fără restricții de funcționalități. Planul găzduit începe de la 4 euro pe lună per proiect dacă preferați să nu rulați un server.

Este codul sursă disponibil?

Serverul, tabloul de bord și imaginea Docker sunt publicate pe GitHub sub licența Elastic 2.0. Puteți citi fiecare linie, puteți rula codul și îl puteți modifica. SDK-urile — React, Vue, Node, Rails și altele — sunt licențiate MIT. Singura restricție: nu puteți oferi software-ul ca serviciu găzduit către terțe părți.

Un întreținător: ce se întâmplă dacă proiectul se oprește?

SDK-urile sunt sub licență MIT și rămân disponibile pe npm, PyPI, RubyGems și alte registre. Serverul este public sub licența Elastic 2.0, iar protocolul dintre ele este documentat, astfel încât oricine poate să îl ruleze, să îl facă fork sau să scrie un server împotriva lui. Traducerile tale rămân într-o singură exportare JSON în orice moment. Dacă serviciul găzduit se oprește: aplicațiile instalate continuă să servească traducerile lor din cache, un client nou revine la limba sursă, iar prin direcționarea SDK-ului către propria ta instanță cu API_URL totul este restaurat. Ce ai pierde este traducerea AI a noilor șiruri de caractere de pe i18n-keyless.com — nu datele tale sau aplicația ta.

Citiți răspunsul complet, cu codul
Contextul nu este doar o cheie deghizată?

Nu. O cheie este obligatorie pentru fiecare șir, trebuie să fie unică și există într-un spațiu de nume global pe care îl întreții manual. Un context este opțional, atașat la câteva șiruri ale căror sens este ambiguu — „Close” pentru a închide fereastra sau „close” în sensul de distanță — și acesta descrie sensul, nu denumește șirul. Majoritatea șirurilor nu au context. Textul sursă rămâne baza de căutare, cu sau fără context; două texte identice cu două contexte sunt pur și simplu două rânduri.

Citiți răspunsul complet, cu codul
Pot să revizuiesc copia într-o cerere de pull?

Da. Șirul sursă este în cod, așa că orice schimbare de formulare este o diferență pe care recenzorul o citește în cererea de tragere, în limbaj clar în loc de un nume de cheie. Ceea ce nu este în git este traducerea în celelalte limbi: aceasta se află în baza de date, la fel ca în cazul oricărei alte platforme de traducere, iar tu o revii în tabloul de bord, unde o marcă „revizuit” pe celulă separă ceea ce a verificat o persoană de ceea ce a scris AI-ul, sau în exportul JSON.

Citiți răspunsul complet, cu codul
De ce nu Tolgee, care este și open source?

Tolgee este o platformă de traducere bazată pe chei sub licența Apache 2.0, cu editare în context, context de capturi de ecran și memorie de traducere; dacă dorești aceste funcționalități sau traducători în proces, este o alegere bună. i18n-keyless nu are chei, nu are fișiere de localizare, traducerea prin AI este activată implicit cu o suprascriere manuală pe care AI nu o rescrie niciodată, un server sub licența Elastic 2.0 cu SDK-uri MIT, și o imagine auto-gazduită care rulează pe SQLite într-un singur container. Pentru o corectare în context, fă o captură de ecran și oferă-o unui agent AI conectat la serverul MCP: acesta găsește șirul și suprascrie traducerea. Pagina de comparație din documentație afișează prețurile una lângă alta.

Citiți răspunsul complet, cu codul
Autogăzduit sau abonament: care?

Auto-gazduit: aceeași imagine Docker pe propriul dvs. server, complet gratuit cu proiecte nelimitate, cu cheia dvs. AI și datele dvs. acasă. Vă place? Dați-mi un sfat! Abonament: noi îl gestionăm, actualizările sunt automate, un preț fix de la 4 € pe lună pe proiect. Alegeți abonamentul dacă preferați să nu administrați un server.

Citiți răspunsul complet, cu codul
Cum pot gestiona valori dinamice precum numele sau numărătoarea?

Folosiți opțiunea de înlocuire. Scrieți propoziția cu un spațiu rezervat — „Bună {name}, ai {count} elemente” — și transmiteți valorile în timpul randării cu replace: { "{name}": userName, "{count}": String(n) }. AI vede spațiul rezervat și îl păstrează în fiecare traducere. SDK-ul înlocuiește valoarea în timpul execuției.

Cum gestionez pluralurile?

Scrieți o formă cu {count} unde numărul este plasat și transmiteți numărul ca count. API-ul stochează un mesaj de plural ICU pe limbă cu exact formele de care are nevoie limba respectivă — două în franceză, patru în rusă, șase în arabă — verificate prin Intl.PluralRules, iar SDK-ul alege cel corect. Adăugați numere ordinale pentru ranguri (1st, 2nd). Nu scrieți niciodată singuri ramurile.

Citiți răspunsul complet, cu codul
Cum să gestionez genurile?

Transmiteți valoarea în select — select={{ gender: "feminin" }} — iar modelul scrie o variantă pentru fiecare valoare, în fiecare limbă, ținând cont de necesitățile lingvistice. Valorile sunt identificatori dintr-o mulțime închisă, cel mult 10 pe variabilă și 2 variabile pe propoziție; un select și un count pot fi combinați. Valorile deschise, precum un nume, rămân un înlocuitor.

Citiți răspunsul complet, cu codul
Cum formatez datele, numerele și monedele?

SDK-ul nu le formatează, o face runtime-ul tău. Folosește Intl.DateTimeFormat și Intl.NumberFormat cu limba curentă din SDK, apoi pune rezultatul în propoziție cu replace. O propoziție, o traducere, formatul corect în fiecare limbă.

Citiți răspunsul complet, cu codul
Pot personaliza promptul de traducere?

Nu, și nu este nevoie să o faci. Promptul citește contextul tău pentru fiecare cheie: aici se stabilesc tonul, publicul și sensul, și acesta este motivul pentru care aceeași cuvânt se traduce diferit în două locuri. Și orice traducere poate fi suprascrisă manual în tabloul de bord; API-ul nu suprascrie niciodată ceea ce ai scris.

Citiți răspunsul complet, cu codul
Are un server MCP pentru agenți de codificare AI?

Da. API-ul este și un server MCP cu autentificare OAuth 2.1. Un agent AI poate lista traduceri, traduce șiruri de caractere, suprascrie valori, importa traduceri existente și gestiona membrii proiectului — aceleași operațiuni pe care le face un om în tabloul de bord. Conectați-l din Claude Code, Cursor, Windsurf sau orice client compatibil MCP.

Pot să îl folosesc pentru șiruri de backend și e-mailuri?

Da. SDK-urile Node.js, Ruby on Rails, Python și Go rulează pe server. Traduceți un subiect de e-mail, un mesaj de eroare sau o notificare push în același mod în care traduceți un șir de interfață utilizator. SDK-urile serverului memorează în cache traducerile în memorie și le actualizează în fundal, astfel încât nu adaugă latență cererii dvs.

Întreaga mea echipă poate lucra la traduceri?

Da. Adăugați membrii echipei la un proiect din tabloul de bord sau prin intermediul API-ului. Fiecare membru poate vedea toate traducerile, poate suprascrie orice valoare și poate adăuga limbi. Administratorii creează proiecte și gestionează membrii. Nu există o prețuire pe loc: adăugați câtă nevoie aveți.

Cum pot să corectez o greșeală de tastare?

Textul sursă este cheia. Dacă corectați o greșeală de tipar în textul sursă, veți obține o nouă cheie cu o nouă traducere; vechea secvență pur și simplu nu mai este cerută, iar tabloul de bord o curăță automat după 30 de zile fără utilizare. O greșeală de tipar într-o traducere: editați celula din tabloul de bord, iar corectura este permanentă.

Citiți răspunsul complet, cu codul