Συχνές ερωτήσεις

Όλα όσα πρέπει να γνωρίζετε για το i18n-keyless πριν ξεκινήσετε.

Χρειάζεται να διαχειρίζομαι αρχεία μετάφρασης;

Όχι. Δεν υπάρχουν αρχεία JSON, ούτε βήμα εξαγωγής κλειδιών, ούτε πρόσθετο κατά τη διάρκεια κατασκευής. Γράφετε τις προτάσεις σας στη γλώσσα πηγής σας, το SDK στέλνει αυτές στην API στην πρώτη αίτηση, η API τις μεταφράζει με τεχνητή νοημοσύνη, και κάθε επόμενη αίτηση εξυπηρετείται από την προσωρινή μνήμη. Ο κώδικάς σας είναι η μοναδική πηγή αλήθειας.

Τι συμβαίνει όταν αλλάζω το κείμενο προέλευσης;

Το κείμενο προέλευσης είναι το κλειδί. Αν το αλλάξετε, θα πάρετε ένα νέο κλειδί με μια νέα μετάφραση από AI. Το παλιό κλειδί απλώς σταματά να ζητείται, ενώ ο πίνακας ελέγχου το καθαρίζει μετά από 30 ημέρες χωρίς χρήση. Η διόρθωση ενός τυπογραφικού λάθους γίνεται με τον ίδιο τρόπο: διορθώστε το στον κώδικα, αναπτύξτε το, και το νέο κείμενο θα μεταφραστεί στην πρώτη αίτηση.

Πόσο κοστίζει;

Αυτο-φιλοξενούμενο: εντελώς δωρεάν, απεριόριστα έργα, χωρίς συνδρομή και χωρίς όριο χρήσης — εγκαταστήστε την εικόνα Docker, χρησιμοποιήστε το δικό σας κλειδί AI. Σας αρέσει; Δώστε μου ένα tip! Φιλοξενούμενο: μία σταθερή τιμή ανά έργο ανά μήνα, ανάλογα με τους ενεργούς χρήστες ανά μήνα — 4 € έως 1.000, 9 € έως 5.000, 29 € έως 50.000, 99 € έως 500.000 — χρεώνεται μηνιαίως, μπορείτε να ακυρώσετε οποτεδήποτε. Δεν υπάρχει τιμολόγηση ανά θέση, ανά λέξη ή ανά συμβολοσειρά και στις δύο περιπτώσεις.

Μπορώ να εξαγάγω τις μεταφράσεις μου;

Ναι. Το ταμπλό διαθέτει ένα κουμπί "Εξαγωγή JSON" που κατεβάζει όλες τις μεταφράσεις του έργου σας ως ένα ενιαίο αρχείο JSON. Η εξαγωγή περιλαμβάνει όλες τις γραμμές, όχι μόνο αυτές που χρησιμοποιήθηκαν τις τελευταίες 30 ημέρες, επομένως πρόκειται για ένα πλήρες αντίγραφο ασφαλείας. Δεν υπάρχει κλείδωμα: τα δεδομένα σας είναι πάντα μόνο μία κλικ μακριά.

Ποιες πλατφόρμες υποστηρίζει;

React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift και Kotlin. Κάθε SDK λειτουργεί με τον ίδιο τρόπο: τυλίξτε το κείμενό σας σε μια κλήση μετάφρασης, και το API επιστρέφει τη μετάφραση για την τρέχουσα γλώσσα. Τα SDK του διακομιστή είναι ασφαλή για νήματα και αποθηκεύουν τις μεταφράσεις στη μνήμη.

Πόσες γλώσσες υποστηρίζονται;

48 γλώσσες, συμπεριλαμβανομένων των περιφερειακών παραλλαγών όπως zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR και es / es-MX. Τα αραβικά, εβραϊκά και ούρντου περιλαμβάνονται επίσης στη λίστα, επομένως λειτουργούν και οι γλώσσες από δεξιά προς τα αριστερά. Η προσθήκη μιας νέας γλώσσας στο έργο σας είναι ένα κλικ στον πίνακα ελέγχου.

Λειτουργεί με την απόδοση πλευράς διακομιστή;

Ναι. Το Node.js SDK χρησιμοποιεί το AsyncLocalStorage, ώστε οι φορτωτές σας, οι λειτουργίες head και τα στοιχεία διακομιστή να μπορούν να μεταφράζουν χωρίς έναν παρόχου React. Στη πλευρά του πελάτη, ο παρόχος React ενυδατώνει από το HTML που έχει αποδοθεί από τον διακομιστή. Στη τεκμηρίωση υπάρχουν οδηγίες βήμα προς βήμα για το Next.js, το Nuxt και το TanStack Start.

Αργοποιεί την εφαρμογή μου;

Την πρώτη φορά που ζητείται μια νέα συμβολοσειρά, η API καλεί το μοντέλο AI — περίπου μισό δευτερόλεπτο για μια σύντομη συμβολοσειρά διεπαφής χρήστη, περισσότερο για μια παράγραφο. Κάθε αίτημα μετά από αυτό εξυπηρετείται από τη βάση δεδομένων, η οποία είναι μια συνηθισμένη επιτυχία στην προσωρινή μνήμη. Το SDK επίσης αποθηκεύει τις μεταφράσεις τοπικά, έτσι οι χρήστες που επιστρέφουν δεν βλέπουν καθυστέρηση δικτύου. Αν δέκα χρήστες ζητήσουν την ίδια συμβολοσειρά ταυτόχρονα, πραγματοποιείται μόνο μία κλήση στο AI.

Τι συμβαίνει εάν η υπηρεσία σταματήσει;

Κάθε SDK αποθηκεύει μεταφράσεις τοπικά — στο localStorage στον ιστό, στο AsyncStorage στα κινητά και στη μνήμη στον διακομιστή. Αν το API δεν είναι προσβάσιμο, το SDK παρέχει τις αποθηκευμένες μεταφράσεις. Οι χρήστες σας βλέπουν την τελευταία γνωστή μετάφραση, ποτέ μια κενή συμβολοσειρά. Όταν το API επανέλθει, το SDK ανανεώνει αθόρυβα.

Ποιος πάροχος AI χρησιμοποιεί;

Υποστηρίζονται πέντε πάροχοι: Mistral, OpenAI, Anthropic, Google και οποιαδήποτε συμβατή με OpenAI τελική σημείο όπως το Ollama, Groq ή Together. Ο χειριστής επιλέγει τον πάροχο και το μοντέλο από τον πίνακα ελέγχου ή το περιβάλλον. Η προεπιλογή στο i18n-keyless.com είναι το Mistral. Οι αυτο-φιλοξενούμενοι χρήστες μπορούν να εκτελέσουν τοπικά το Ollama και να μην στείλουν τίποτα σε τρίτο μέρος.

Μπορώ να παρακάμψω μια μετάφραση AI;

Ναι. Κάντε κλικ σε οποιοδήποτε κελί στον πίνακα ελέγχου, πληκτρολογήστε το σωστό κείμενο και αποθηκεύστε το. Η διόρθωση είναι μόνιμη: το API δεν αντικαθιστά ποτέ μια τιμή που έχει οριστεί χειροκίνητα. Μπορείτε επίσης να παρακάμψετε τις μεταφράσεις μέσω του API ή μέσω του διακομιστή MCP, ώστε ένας πράκτορας κωδικοποίησης AI να μπορεί να διορθώσει μια μετάφραση για εσάς.

Μπορώ να μεταβώ από το i18next ή άλλη βιβλιοθήκη;

Ναι. Στη τεκμηρίωση υπάρχει ένας οδηγός βήμα προς βήμα για τη μετανάστευση του i18next, του react-intl και του Lokalise. Το API διαθέτει ένα τελικό σημείο μετανάστευσης που εισάγει τις υπάρχουσες μεταφράσεις σας μία προς μία, χωρίς κλήση AI ή χρέωση. Ο διακομιστής MCP διαθέτει το ίδιο εργαλείο, ώστε ένας πράκτορας AI να μπορεί να πραγματοποιήσει τη μετανάστευση για εσάς.

Υπάρχει κάποιο δωρεάν πρόγραμμα;

Η αυτόνομη έκδοση είναι εντελώς δωρεάν με απεριόριστα έργα — εγκαταστήστε την εικόνα Docker, χρησιμοποιήστε το δικό σας κλειδί AI και κρατήστε τα δεδομένα σας στον δικό σας διακομιστή. Χωρίς χρονικό περιορισμό, χωρίς περιορισμούς χαρακτηριστικών. Το πρόγραμμα φιλοξενίας ξεκινά από 4 ευρώ ανά μήνα ανά έργο εάν προτιμάτε να μην τρέξετε έναν διακομιστή.

Είναι ο πηγαίος κώδικας διαθέσιμος;

Ο διακομιστής, ο πίνακας ελέγχου και η εικόνα Docker δημοσιεύονται στο GitHub υπό την Elastic License 2.0. Μπορείτε να διαβάσετε κάθε γραμμή, να εκτελέσετε τον κώδικα και να τον τροποποιήσετε. Τα SDK — React, Vue, Node, Rails και άλλα — έχουν άδεια MIT. Ο μόνος περιορισμός: δεν επιτρέπεται να προσφέρετε το λογισμικό ως υπηρεσία φιλοξενίας σε τρίτους.

Ένας συντηρητής: τι συμβαίνει αν σταματήσει το έργο;

Τα SDK υπόκεινται στην άδεια MIT και παραμένουν διαθέσιμα στο npm, PyPI, RubyGems και άλλους καταλόγους. Ο διακομιστής είναι δημόσιος υπό την Elastic License 2.0 και το πρωτόκολλο μεταξύ τους τεκμηριώνεται, ώστε οποιοσδήποτε μπορεί να το εκτελέσει, να το κάνει fork ή να γράψει έναν διακομιστή εναντίον του. Οι μεταφράσεις σας παραμένουν σε μία μόνο εξαγωγή JSON ανά πάσα στιγμή. Αν η φιλοξενούμενη υπηρεσία σταματήσει: οι εγκατεστημένες εφαρμογές συνεχίζουν να παρέχουν τις μεταφράσεις τους από την προσωρινή μνήμη, ένας νέος πελάτης επιστρέφει στη γλώσσα πηγής, και η κατεύθυνση του SDK στην προσωπική σας παρουσία με API_URL αποκαθιστά τα πάντα. Αυτό που θα χάσετε είναι η μεταφράση μέσω AI νέων συμβολοσειρών στο i18n-keyless.com — όχι τα δεδομένα σας ούτε την εφαρμογή σας.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Δεν είναι το πλαίσιο μόνο ένα κλειδί μεταμφιεσμένο;

Όχι. Ένας κλειδί είναι υποχρεωτικός για κάθε συμβολοσειρά, πρέπει να είναι μοναδικός και βρίσκεται σε έναν παγκόσμιο χώρο ονομάτων τον οποίο διατηρείτε χειροκίνητα. Ένας πλαίσιο είναι προαιρετικό, συνδέεται μόνο με τις λίγες συμβολοσειρές των οποίων η σημασία είναι ασαφής — π.χ. "Close" για κλείσιμο του παραθύρου ή "close" ως έννοια εγγύτητας — και περιγράφει τη σημασία, δεν ονομάζει τη συμβολοσειρά. Οι περισσότερες συμβολοσειρές δεν έχουν πλαίσιο. Το αρχικό κείμενο χρησιμεύει ως αναφορά, είτε υπάρχει πλαίσιο είτε όχι. δύο ίδια κείμενα με δύο διαφορετικά πλαίσια είναι απλώς δύο γραμμές.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Μπορώ να ελέγξω το αντίγραφο σε ένα pull request;

Ναι. Η αρχική συμβολοσειρά βρίσκεται στον κώδικα, οπότε κάθε αλλαγή στη διατύπωση είναι μια διαφορά που ο αναθεωρητής διαβάζει στο αίτημα έλξης, σε απλή γλώσσα αντί για το όνομα ενός κλειδιού. Αυτό που δεν υπάρχει στο git είναι η μετάφραση στις άλλες γλώσσες: αυτή βρίσκεται στη βάση δεδομένων, όπως συμβαίνει με οποιαδήποτε πλατφόρμα μετάφρασης, και το ελέγχετε στον πίνακα ελέγχου, όπου μια σήμανση «ελεγμένο» ανά κελί διαχωρίζει αυτό που έλεγξε ένας άνθρωπος από αυτό που έγραψε η ΤΝ, ή στην εξαγωγή JSON.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Γιατί όχι το Tolgee, το οποίο είναι επίσης ανοικτού κώδικα;

Το Tolgee είναι μια πλατφόρμα μετάφρασης βασισμένη σε κλειδιά υπό την άδεια Apache 2.0, με επεξεργασία εντός контекста, контекст στιγμιοτύπων οθόνης και μνήμη μετάφρασης. Αν θέλετε αυτές τις λειτουργίες ή μεταφραστές στη διαδικασία, είναι μια καλή επιλογή. Το i18n-keyless δεν έχει κλειδιά, δεν έχει αρχεία τοπικοποίησης, η μετάφραση μέσω AI είναι ενεργοποιημένη από προεπιλογή με χειροκίνητη αντικατάσταση που η AI δεν ξαναγράφει ποτέ, ένας διακομιστής υπό την Elastic License 2.0 με MIT SDKs, και μια αυτο-φιλοξενούμενη εικόνα που λειτουργεί σε SQLite μέσα σε ένα κοντέινερ. Για μια διόρθωση εντός контекста, τραβήξτε μια στιγμιότυπο οθόνης και δώστε το σε έναν πράκτορα AI συνδεδεμένο με τον διακομιστή MCP: αυτός βρίσκει τη συμβολοσειρά και αντικαθιστά τη μετάφραση. Η σελίδα σύγκρισης στις τεκμηριώσεις παρουσιάζει τις τιμές δίπλα-δίπλα.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Αυτο-φιλοξενούμενο ή συνδρομή: ποιο;

Αυτο-φιλοξενούμενο: η ίδια εικόνα Docker στον δικό σας διακομιστή, εντελώς δωρεάν με απεριόριστα έργα, με το δικό σας κλειδί AI και τα δεδομένα σας στο σπίτι. Σας αρέσει; Δώστε μου ένα φιλοδώρημα! Συνδρομή: το διαχειριζόμαστε εμείς, οι ενημερώσεις είναι αυτόματες, μία σταθερή τιμή από 4 € ανά μήνα ανά έργο. Επιλέξτε τη συνδρομή εάν προτιμάτε να μην διαχειρίζεστε έναν διακομιστή.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Πώς μπορώ να χειριστώ δυναμικές τιμές όπως ονόματα ή αριθμοί;

Χρησιμοποιήστε την επιλογή αντικατάστασης. Γράψτε την πρόταση με μια θέση κράτησης — «Γειά σου {name}, έχεις {count} αντικείμενα» — και περάστε τις τιμές κατά την απόδοση με replace: { "{name}": userName, "{count}": String(n) }. Η ΤΝ βλέπει τη θέση κράτησης και τη διατηρεί σε κάθε μετάφραση. Το SDK αντικαθιστά την τιμή κατά την εκτέλεση.

Πώς χειρίζομαι τους πληθυντικούς;

Γράψτε μία μορφή με {count} όπου τοποθετείται ο αριθμός και περάστε τον αριθμό ως count. Το API αποθηκεύει ένα μήνυμα πληθυσμού ICU ανά γλώσσα με ακριβώς τις μορφές που χρειάζεται η γλώσσα — δύο στα γαλλικά, τέσσερα στα ρωσικά, έξι στα αραβικά — ελεγχόμενα μέσω Intl.PluralRules, και το SDK επιλέγει τη σωστή. Προσθέστε τα порядковые αριθμοί για τις κατατάξεις (1st, 2nd). Ποτέ δεν γράφετε μόνοι σας τα branches.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Πώς χειρίζομαι τα φύλα;

Μεταβιβάστε την τιμή στο select — select={{ gender: "γυναίκα" }} — και το μοντέλο γράφει μία παραλλαγή ανά τιμή, σε κάθε γλώσσα, λαμβάνοντας υπόψη τις γλωσσικές ανάγκες. Οι τιμές είναι ταυτότητες από ένα κλειστό σύνολο, έως 10 ανά μεταβλητή και 2 μεταβλητές ανά πρόταση. Μπορεί να συνδυαστεί ένα select και ένα count. Οι ανοιχτές τιμές όπως ένα όνομα παραμένουν ως αντικατάσταση.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Πώς μορφοποιώ τις ημερομηνίες, τους αριθμούς και τα νομίσματα;

Το SDK δεν τα μορφοποιεί, το κάνει αυτό το runtime σας. Χρησιμοποιήστε το Intl.DateTimeFormat και το Intl.NumberFormat με τη τρέχουσα γλώσσα από το SDK και τοποθετήστε το αποτέλεσμα στην πρόταση με replace. Μία πρόταση, μία μετάφραση, η σωστή μορφή σε κάθε γλώσσα.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Μπορώ να προσαρμόσω την προτροπή μετάφρασης;

Όχι, και δεν χρειάζεται να το κάνετε. Η προτροπή διαβάζει το πλαίσιο σας για κάθε κλειδί: εκεί ορίζονται ο τόνος, το κοινό και το νόημα, και αυτό είναι που κάνει την ίδια λέξη να μεταφράζεται διαφορετικά σε δύο διαφορετικά μέρη. Και οποιαδήποτε μετάφραση μπορεί να αντικατασταθεί χειροκίνητα από τον πίνακα ελέγχου. το API δεν αντικαθιστά ποτέ αυτό που γράφετε.

Διαβάστε την πλήρη απάντηση, με τον κώδικα
Έχει έναν διακομιστή MCP για πράκτορες κωδικοποίησης AI;

Ναι. Το API είναι επίσης ένας διακομιστής MCP με έλεγχο ταυτότητας OAuth 2.1. Ένας πράκτορας AI μπορεί να καταγράψει μεταφράσεις, να μεταφράσει συμβολοσειρές, να αντικαταστήσει τιμές, να εισαγάγει υπάρχουσες μεταφράσεις και να διαχειριστεί μέλη του έργου — τις ίδιες λειτουργίες που κάνει ένας άνθρωπος στον πίνακα ελέγχου. Συνδέστε το από το Claude Code, το Cursor, το Windsurf ή οποιονδήποτε πελάτη συμβατό με MCP.

Μπορώ να το χρησιμοποιήσω για συμβολοσειρές backend και emails;

Ναι. Τα SDK του Node.js, Ruby on Rails, Python και Go εκτελούνται στον διακομιστή. Μεταφράστε ένα θέμα email, ένα μήνυμα σφάλματος ή μια ειδοποίηση push με τον ίδιο τρόπο όπως μεταφράζετε μια συμβολοσειρά διεπαφής χρήστη. Τα SDK του διακομιστή αποθηκεύουν τις μεταφράσεις στη μνήμη και ανανεώνουν στο παρασκήνιο, οπότε δεν προσθέτουν καθυστέρηση στο αίτημά σας.

Μπορεί η ομάδα μου να εργαστεί στις μεταφράσεις;

Ναι. Προσθέστε μέλη ομάδας σε ένα έργο από τον πίνακα ελέγχου ή μέσω του API. Κάθε μέλος μπορεί να δει όλες τις μεταφράσεις, να αντικαταστήσει οποιαδήποτε τιμή και να προσθέσει γλώσσες. Οι διαχειριστές δημιουργούν έργα και διαχειρίζονται μέλη. Δεν υπάρχει τιμολόγηση ανά θέση: προσθέστε όσοι ανθρώπους χρειάζεστε.

Πώς μπορώ να διορθώσω ένα τυπογραφικό λάθος;

Το κείμενο προέλευσης είναι το κλειδί. Αν διορθώσετε ένα τυπογραφικό λάθος στο κείμενο προέλευσης, θα λάβετε ένα νέο κλειδί με μια νέα μετάφραση. το παλιό κείμενο απλώς σταματά να ζητείται και το ταμπλό το καθαρίζει αυτόματα μετά από 30 ημέρες χωρίς χρήση. Ένα τυπογραφικό λάθος σε μια μετάφραση: επεξεργαστείτε το κελί στο ταμπλό και η διόρθωση είναι μόνιμη.

Διαβάστε την πλήρη απάντηση, με τον κώδικα