자주 묻는 질문

Everything you need to know about i18n-keyless before you start.

번역 파일을 관리해야 하나요?

아니요. JSON 파일이 없고, 키 추출 단계도 없으며, 빌드 시 플러그인도 없습니다. 소스 언어로 문장을 작성하면 SDK가 첫 요청 시 API로 전송하고, API가 AI로 번역하며, 이후 모든 요청은 캐시에서 제공됩니다. 코드가 유일한 진실의 원천입니다.

원본 텍스트를 변경하면 어떻게 됩니까?

원본 텍스트는 키입니다. 변경하면 새로운 AI 번역이 포함된 새로운 키를 얻을 수 있습니다. 이전 키는 더 이상 요청되지 않으며 대시보드는 30일 동안 사용하지 않으면 정리합니다. 오타 수정도 동일합니다: 코드에서 수정하고 배포하면 새로운 텍스트가 첫 요청 시 번역됩니다.

얼마예요?

호스팅된 플랜은 프로젝트당 매월 8유로로, 매월 청구되며 언제든지 취소할 수 있습니다. 자체 호스팅 버전은 하나의 프로젝트에 무료입니다. 무제한 프로젝트의 경우 한 번에 30유로 — 구독 없음, 사용 제한 없음. 두 경우 모두 자체 AI 키를 가져옵니다. 좌석, 단어 또는 요청 당 가격은 없습니다.

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유로, 자체 AI 키와 데이터를 집에서 관리. 서버를 직접 운영하고자 하는 경우를 제외하고 구독을 선택하세요.

코드와 함께 전체 답변을 읽으세요
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는 없습니다. 각 형태를 자체 완전한 문장으로 작성하세요 — "1개 항목"과 "{count}개 항목" — 그리고 대체로 숫자를 삽입하세요. 모델은 각 문장을 자체 언어로 번역하므로, 더 많은 형태를 가진 언어들도 일반적인 경우에 자연스럽게 읽힙니다.

코드와 함께 전체 답변을 읽으세요
성별을 어떻게 다루나요?

같은 방식으로: 각 폼당 하나의 완전한 문장, 그리고 모델에게 누가 말하고 누구에게 말하는지 알려주는 맥락이 필요합니다. 두 개의 맥락은 같은 단어를 두 개의 별개의 번역으로 제공하므로, "Welcome back"이 여성과 남성에게 결코 충돌하지 않습니다.

코드와 함께 전체 답변을 읽으세요
날짜, 숫자 및 통화를 어떻게 형식화합니까?

SDK는它们을 포맷하지 않으며, 런타임이 처리합니다. SDK의 현재 언어로 Intl.DateTimeFormat 및 Intl.NumberFormat을 사용한 다음, 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일 동안 사용되지 않으면 자동으로 정리됩니다. 번역의 오타: 대시보드에서 셀을 편집하면 수정이 영구적입니다.

코드와 함께 전체 답변을 읽으세요