الأسئلة المتداولة
Everything you need to know about i18n-keyless before you start.
هل أحتاج إلى إدارة ملفات الترجمة؟
لا. لا توجد ملفات JSON، ولا خطوة لاستخراج المفاتيح، ولا مكون إضافي وقت البناء. تكتب جملتك باللغة المصدر، ويرسل SDK هذه الجمل إلى واجهة برمجة التطبيقات (API) في أول طلب، وتقوم واجهة برمجة التطبيقات بترجمتها باستخدام الذكاء الاصطناعي، ويتم تقديم كل طلب لاحق من الذاكرة المؤقتة. يعتبر الكود الخاص بك المصدر الوحيد للحقيقة.
ماذا يحدث عندما أقوم بتغيير النص المصدر؟
النص المصدر هو المفتاح. قم بتغييره وستحصل على مفتاح جديد مع ترجمة ذكاء اصطناعي جديدة. يتوقف المفتاح القديم ببساطة عن طلبه، ويقوم لوحة التحكم بإزالته بعد 30 يومًا من عدم استخدامه. إصلاح الخطأ الإملائي هو نفسه: قم بإصلاحه في الكود، ونشره، وسيتم ترجمة النص الجديد في أول طلب.
كم يكلف؟
الخطة المستضافة هي 8 يورو لكل مشروع شهريًا، يتم تحصيلها شهريًا، يمكنك الإلغاء في أي وقت. النسخة المستضافة ذاتيًا مجانية لمشروع واحد؛ 30 يورو لمرة واحدة لمشاريع غير محدودة — بدون اشتراك، بدون حد للاستخدام. يمكنك إحضار مفتاح الذكاء الاصطناعي الخاص بك في كلتا الحالتين. لا يوجد تسعير لكل مقعد أو لكل كلمة أو لكل طلب.
Can I export my translations?
Yes. The dashboard has an "Export JSON" button that downloads every translation in your project as a single JSON file. The export includes all rows, not just the ones used in the last 30 days, so it is a full backup. There is no lock-in: your data is always one click away.
What frameworks does it support?
React, React Native, Vue, Svelte, Vanilla JS, Node.js, Ruby on Rails, Python, Go, Swift and Kotlin. Every SDK works the same way: wrap your text in a translation call, and the API returns the translation for the current language. The server SDKs are thread-safe and cache translations in memory.
How many languages are supported?
48 languages, including regional variants like zh-Hans / zh-Hant, en / en-GB, fr / fr-CA, pt / pt-BR, and es / es-MX. Arabic, Hebrew and Urdu are in the list, so right-to-left languages work too. Adding a new language to your project is one click in the dashboard.
Does it work with server-side rendering?
Yes. The Node.js SDK uses AsyncLocalStorage so your loaders, head functions and server components can translate without a React provider. On the client side, the React provider hydrates from the server-rendered HTML. There are step-by-step guides for Next.js, Nuxt, and TanStack Start in the documentation.
Does it slow down my app?
The first time a new string is requested, the API calls the AI model — that takes one to two seconds. Every request after that is served from the database, which is a regular cache hit. The SDK also caches translations locally, so returning users see zero network delay. If ten users request the same string at the same time, only one AI call is made.
What happens if the service goes down?
Every SDK caches translations locally — in localStorage on the web, AsyncStorage on mobile, and in memory on the server. If the API is unreachable, the SDK serves the cached translations. Your users see the last known translation, never a blank string. When the API comes back, the SDK refreshes silently.
Which AI provider does it use?
Five providers are supported: Mistral, OpenAI, Anthropic, Google, and any OpenAI-compatible endpoint such as Ollama, Groq, or Together. The operator picks the provider and the model from the dashboard or from the environment. The default on i18n-keyless.com is Mistral. Self-hosted users can run Ollama locally and send nothing to a third party.
Can I override an AI translation?
Yes. Click any cell in the dashboard, type the correct text, and save. The fix is permanent: the API never overwrites a value that was set by hand. You can also override translations through the API or through the MCP server, so an AI coding agent can fix a translation for you.
Can I migrate from i18next or another library?
Yes. There is a step-by-step migration guide for i18next, react-intl, and Lokalise in the documentation. The API has a migrate endpoint that imports your existing translations one by one, with no AI call and nothing billed. The MCP server has the same tool, so an AI agent can do the migration for you.
Is there a free plan?
There is no time-limited free trial. The self-hosted edition gives you one project free forever — install the Docker image, use your own AI key, and keep your data on your own server. The hosted plan is €8 per month per project, with no minimum commitment.
Is the source code available?
The server, the dashboard and the Docker image are published on GitHub under the Elastic License 2.0. You can read every line, run the code, and change it. The SDKs — React, Vue, Node, Rails and the others — are MIT-licensed. The only restriction: you may not offer the software as a hosted service to third parties.
مستضاف ذاتيًا أم اشتراك: أيهما؟
الاشتراك: نديره نحن، التحديثات تلقائية، سعر واحد لكل مشروع. الاستضافة الذاتية: نفس صورة Docker بالضبط على خادمك الخاص، مجاناً للتثبيت، مشروع واحد مجاناً إلى الأبد، 30 يورو لمرة واحدة لمشاريع غير محدودة، مع مفتاح الذكاء الاصطناعي الخاص بك وبياناتك في منزلك. اختر الاشتراك إلا إذا كنت تريد تشغيل خادم.
اقرأ الإجابة الكاملة مع الكودHow do I handle dynamic values like names or counts?
Use the replace option. Write the sentence with a placeholder — "Hello {name}, you have {count} items" — and pass the values at render time with replace: { "{name}": userName, "{count}": String(n) }. The AI sees the placeholder and keeps it in every translation. The SDK substitutes the value at runtime.
كيف أتعامل مع الجمع؟
لا توجد واجهة برمجة تطبيقات (API) للجمع، وهذا مقصود. اكتب كل شكل كجملة كاملة خاصة به — "عنصر واحد" و"{count} عناصر" — وأدخل العدد باستخدام الاستبدال. يترجم النموذج كل جملة بلغتها الخاصة، لذا ستقرأ اللغات التي تحتوي على أشكال أكثر الحالات الشائعة بشكل طبيعي.
اقرأ الإجابة الكاملة مع الكودكيف أتعامل مع الجنسين؟
بنفس الطريقة: جملة كاملة واحدة لكل نموذج، بالإضافة إلى سياق يخبر النموذج بمن يتحدث ومن يتم توجيه الخطاب إليه. السياقان يعطيان ترجمتين منفصلتين لنفس الكلمات، لذا فإن "مرحبًا بعودتك" للمرأة وللرجل لن يتعارضا أبدًا.
اقرأ الإجابة الكاملة مع الكودكيف أقوم بتنسيق التواريخ والأرقام والعملات؟
تعمل SDK على تنسيقها، بينما يقوم وقت التشغيل الخاص بك بذلك. استخدم Intl.DateTimeFormat وIntl.NumberFormat مع اللغة الحالية من SDK، ثم ضع النتيجة في الجملة باستخدام replace. جملة واحدة، ترجمة واحدة، التنسيق الصحيح في كل لغة.
اقرأ الإجابة الكاملة مع الكودهل يمكنني تخصيص مطالبة الترجمة؟
لا، ولا تحتاج إلى ذلك. يقرأ المطالَب سياقك لكل مفتاح: هنا تحدد النبرة والجمهور والمعنى، وهو ما يجعل نفس الكلمة تترجم بشكل مختلف في مكانين. ويمكن لأي ترجمة أن يتم تعديلها يدويًا من خلال لوحة التحكم؛ فـ API لا تعيد كتابة ما كتبته.
اقرأ الإجابة الكاملة مع الكودDoes it have an MCP server for AI coding agents?
Yes. The API is also an MCP server with OAuth 2.1 authentication. An AI agent can list translations, translate strings, override values, import existing translations, and manage project members — the same operations a human does in the dashboard. Connect it from Claude Code, Cursor, Windsurf, or any MCP-compatible client.
Can I use it for backend strings and emails?
Yes. The Node.js, Ruby on Rails, Python and Go SDKs run on the server. Translate an email subject, an error message, or a push notification the same way you translate a UI string. The server SDKs cache translations in memory and refresh in the background, so they do not add latency to your request.
Can my whole team work on translations?
Yes. Add team members to a project from the dashboard or through the API. Every member can see all translations, override any value, and add languages. Admins create projects and manage members. There is no per-seat pricing: add as many people as you need.
كيف يمكنني إصلاح خطأ إملائي؟
النص المصدر هو المفتاح. قم بإصلاح خطأ إملائي في المصدر وستحصل على مفتاح جديد بترجمة جديدة؛ يتوقف просто الطلب القديم للنص القديم عن الظهور، ويقوم لوحة التحكم بمسحه تلقائيًا بعد 30 يومًا من عدم استخدامه. خطأ إملائي في الترجمة: قم بتعديل الخلية في لوحة التحكم، وسيكون الإصلاح دائمًا.
اقرأ الإجابة الكاملة مع الكود