자주 묻는 질문

시작하기 전에 i18n-keyless에 대해 알아야 할 모든 것입니다.

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

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

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

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

얼마예요?

셀프 호스팅: 완전히 무료, 무제한 프로젝트, 구독 없음 및 사용 제한 없음 — 도커 이미지를 설치하고 자체 AI 키를 사용하세요. 마음에 드나요? tip me! 호스팅: 월간 활성 사용자 수에 따라 프로젝트당 월 고정 가격 — 1,000까지 4유로, 5,000까지 9유로, 50,000까지 29유로, 500,000까지 99유로 — 월별로 청구되며 언제든 취소 가능. 두 경우 모두 좌석당, 단어당 또는 문자열당 가격은 없습니다.

내 번역을 내보낼 수 있나요?

예. 대시보드에는 프로젝트의 모든 번역을 단일 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 모델을 호출합니다 — 짧은 UI 문자열의 경우 약 0.5초, 문단의 경우 더 오래 걸립니다. 이후 모든 요청은 데이터베이스에서 제공되며, 이는 일반적인 캐시 히트입니다. SDK는 로컬에서도 번역을 캐시하므로 재방문 사용자는 네트워크 지연을 경험하지 않습니다. 동시에 10명의 사용자가 동일한 문자열을 요청하더라도 AI 호출은 한 번만 이루어집니다.

서비스가 중단되면 어떻게 됩니까?

모든 SDK는 로컬에서 번역을 캐시합니다 — 웹에서는 localStorage, 모바일에서는 AsyncStorage, 서버에서는 메모리에 저장됩니다. API에 접근할 수 없으면 SDK는 캐시된 번역을 제공합니다. 사용자는 마지막 알려진 번역을 보게 되며, 빈 문자열은 절대 표시되지 않습니다. API가 복구되면 SDK가 조용히 새로고침됩니다.

어떤 AI 제공자를 사용합니까?

다섯 개의 제공업체가 지원됩니다: Mistral, OpenAI, Anthropic, Google 및 Ollama, Groq, Together와 같은 OpenAI 호환 엔드포인트. 운영자가 대시보드 또는 환경에서 제공업체와 모델을 선택합니다. i18n-keyless.com의 기본값은 Mistral입니다. 자체 호스팅 사용자는 로컬에서 Ollama를 실행하고 제3자에게 아무것도 보내지 않을 수 있습니다.

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 라이선스로 제공됩니다. 유일한 제한: 소프트웨어를 호스팅 서비스 형태로 제3자에게 제공할 수 없습니다.

유지 관리자 한 명: 프로젝트가 중단되면 어떻게 됩니까?

SDK는 MIT 라이선스 하에 있으며 npm, PyPI, RubyGems 및 기타 레지스트리에 계속 사용할 수 있습니다. 서버는 Elastic License 2.0 하에 공개되어 있으며その間의 프로토콜이 문서화되어 있어 누구나 실행, 포크 또는 서버를 작성할 수 있습니다. 번역은 언제든지 하나의 JSON 내보내기에 남아 있습니다. 호스팅된 서비스가 중단되면: 설치된 앱은 캐시된 번역을 계속 제공하고, 새로운 클라이언트는 소스 언어로 되돌아갑니다. SDK를 API_URL로 자체 인스턴스를 가리키면 모든 것이 복원됩니다. 잃게 되는 것은 i18n-keyless.com의 새로운 문자열에 대한 AI 번역뿐입니다. 데이터나 앱이 아닙니다.

코드와 함께 전체 답변을 읽으세요
맥락이 단순히 위장한 키가 아닙니까?

아니요. 모든 문자열에는 키가 필수이며 고유해야 하며, 수동으로 관리하는 전역 네임스페이스에 존재합니다. 컨텍스트는 선택 사항으로, 의미가 모호한 일부 문자열에 첨부됩니다 — 예를 들어 "Close"는 창문을 닫는 것인지 거리상으로 닫는 것인지 — 그리고 이는 문자열의 이름을 지정하는 것이 아니라 의미를 설명합니다. 대부분의 문자열에는 컨텍스트가 없습니다. 원본 텍스트는 검색의 기준이 되며, 컨텍스트의 유무에 관계없이; 동일한 텍스트가 두 개의 컨텍스트를 가지고 있다면 단순히 두 줄입니다.

코드와 함께 전체 답변을 읽으세요
풀 리퀘스트에서 복사본을 검토할 수 있나요?

예. 소스 문자열은 코드에 있으므로 모든 문구 변경은 검토자가 키 이름 대신 평이한 언어로 풀 요청에서 읽는 차이입니다. 깃에 없는 것은 다른 언어들로의 번역입니다. 그것은 데이터베이스에 저장되어 있으며, 모든 번역 플랫폼과 마찬가지로 대시보드에서 확인할 수 있으며, 각 셀의 "검토됨" 마크가 사람이 확인한 것과 AI가 작성한 것을 구분합니다. 또는 JSON 내보내기에서 확인할 수 있습니다.

코드와 함께 전체 답변을 읽으세요
왜 Tolgee를 선택하지 않나요? 그것도 오픈 소스잖아요?

Tolgee는 Apache 2.0 라이선스 하의 키 기반 번역 플랫폼으로, 인컨텍스트 편집, 스크린샷 컨텍스트 및 번역 메모리를 제공합니다. 이러한 기능이나 번역가를 프로세스에 포함하고 싶다면 좋은 선택입니다. i18n-keyless는 키가 없으며, 로케일 파일이 없으며, AI 번역이 기본적으로 활성화되어 있으며 수동 오버라이드가 AI에 의해 다시 작성되지 않습니다. MIT SDK가 포함된 Elastic License 2.0 서버와 하나의 컨테이너에서 SQLite를 실행하는 자체 호스팅 이미지가 있습니다. 인컨텍스트 수정을 위해 스크린샷을 찍고 MCP 서버에 연결된 AI 에이전트에 제공하세요. 에이전트가 문자열을 찾고 번역을 오버라이드합니다. 문서의 비교 페이지에서 가격이 나란히 표시됩니다.

코드와 함께 전체 답변을 읽으세요
셀프 호스팅 또는 구독: 어느 쪽입니까?

셀프 호스팅: 자체 서버에 동일한 Docker 이미지를 무료로 무제한 프로젝트와 자체 AI 키 및 데이터와 함께 사용하세요. 마음에 드나요? 팁을 주세요! 구독: 저희가 관리하며 자동 업데이트, 프로젝트당 월 4유로의 고정 가격입니다. 서버를 직접 운영하고 싶지 않다면 구독을 선택하세요.

코드와 함께 전체 답변을 읽으세요
이름이나 개수와 같은 동적 값을 어떻게 처리하나요?

대체 옵션을 사용하세요. 플레이스홀더가 포함된 문장을 작성하세요 — "안녕하세요 {name}, {count}개의 항목이 있습니다" — 그리고 렌더링 시 replace로 값을 전달하세요: { "{name}": userName, "{count}": String(n) }. AI는 플레이스홀더를 인식하고 모든 번역에서 이를 유지합니다. SDK는 런타임에 값을 대체합니다.

복수형을 어떻게 처리하나요?

{count}을(를) 포함하는 하나의 형태를 작성하고 숫자를 count로 전달하세요. API는 각 언어에 필요한 정확한 형태(프랑스어는 2개, 러시아어는 4개, 아랍어는 6개)로 ICU 복수 메시지를 저장하며, Intl.PluralRules로 검증하고 SDK가 올바른 것을 선택합니다. 순위에는 서수(1st, 2nd)를 추가하세요. 여러분 스스로 브랜치를 작성하지 마세요.

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

select에 값을 전달하세요 — select={{ gender: "여성" }} — 그러면 모델이 각 값에 대해 하나의 변형을 모든 언어에서 언어 요구 사항을 고려하여 작성합니다. 값은 닫힌 집합의 식별자로, 변수당 최대 10개, 문장당 최대 2개의 변수가 있습니다. select와 count를 결합할 수 있습니다. 이름과 같은 열린 값은 대체로 남습니다.

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

SDK는它们을 포맷하지 않으며, 런타임이 처리합니다. SDK의 현재 언어로 Intl.DateTimeFormat 및 Intl.NumberFormat을 사용한 다음, replace로 결과를 문장에 삽입하세요. 한 문장, 한 번역, 모든 언어에서 올바른 형식입니다.

코드와 함께 전체 답변을 읽으세요
번역 프롬프트를 사용자 정의할 수 있나요?

아니요, 그럴 필요도 없습니다. 프롬프트는 각 키에 대한 여러분의 맥락을 읽습니다. там에서 톤, 대상 및 의미가 결정되며, 이것이 동일한 단어가 두 곳에서 다르게 번역되는 이유입니다. 그리고 어떤 번역도 대시보드에서 수동으로 덮어쓸 수 있습니다. API는 당신이 작성한 내용을 덮어쓰지 않습니다.

코드와 함께 전체 답변을 읽으세요
AI 코딩 에이전트를 위한 MCP 서버가 있나요?

네. API는 OAuth 2.1 인증을 사용하는 MCP 서버이기도 합니다. AI 에이전트는 번역을 나열하고, 문자열을 번역하며, 값을 덮어쓰고, 기존 번역을 가져오고, 프로젝트 멤버를 관리할 수 있습니다. 이는 사람이 대시보드에서 수행하는 동일한 작업입니다. Claude Code, Cursor, Windsurf 또는 모든 MCP 호환 클라이언트에서 연결하세요.

백엔드 문자열과 이메일에 사용할 수 있나요?

예. Node.js, Ruby on Rails, Python 및 Go SDK는 서버에서 실행됩니다. 이메일 제목, 오류 메시지 또는 푸시 알림을 UI 문자열을 번역하는 것과 동일한 방식으로 번역하세요. 서버 SDK는 메모리에 번역을 캐시하고 백그라운드에서 새로고침하므로 요청에 지연을 추가하지 않습니다.

저희 팀 전체가 번역 작업을 할 수 있나요?

예. 대시보드 또는 API를 통해 프로젝트에 팀 멤버를 추가하세요. 모든 멤버는 모든 번역을 볼 수 있으며, 모든 값을 덮어쓸 수 있고, 언어를 추가할 수 있습니다. 관리자는 프로젝트를 만들고 멤버를 관리합니다. 좌석당 가격은 없습니다. 필요에 따라 인원을 추가하세요.

오타를 어떻게 수정하나요?

소스 텍스트가 키입니다. 소스의 오타를 수정하면 새로운 키와 새로운 번역을 얻을 수 있습니다. 이전 문자열은 더 이상 요청되지 않으며 대시보드가 30일 동안 사용되지 않으면 자동으로 정리됩니다. 번역의 오타: 대시보드에서 셀을 편집하면 수정이 영구적입니다.

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