よくある質問
始める前に知っておくべき i18n-keyless についてのすべて。
翻訳ファイルを管理する必要がありますか?
いいえ。JSONファイルはありません。キー抽出ステップもビルド時プラグインもありません。ソース言語で文章を書き、SDKが最初のリクエストでそれらをAPIに送信します。APIがAIで翻訳し、その後のリクエストはすべてキャッシュから提供されます。あなたのコードが唯一の真実の源です。
ソーステキストを変更するとどうなりますか?
ソーステキストはキーです。変更すると、新しいキーと新鮮なAI翻訳が得られます。古いキーは単にリクエストされなくなり、ダッシュボードは30日間使用されないとクリーンアップします。タイプミスの修正も同じです。コードで修正してデプロイすると、新しいテキストは最初のリクエストで翻訳されます。
いくらですか?
セルフホスト: 完全に無料、無制限のプロジェクト、サブスクリプション不要で使用制限もなし — Dockerイメージをインストールし、独自のAIキーを使用します。気に入りましたか? tip me! ホスト版: プロジェクトごとの月額固定料金(月間アクティブユーザー数に応じて) — 1,000まで4€、5,000まで9€、50,000まで29€、500,000まで99€ — 月額請求、いつでも解約可能。どちらのプランも、席数、単語数、文字列ごとの課金はありません。
翻訳をエクスポートできますか?
はい。ダッシュボードには「JSON をエクスポート」ボタンがあり、プロジェクト内のすべての翻訳を 1 つの JSON ファイルとしてダウンロードします。エクスポートには、過去 30 日間に使用されたものだけでなく、すべての行が含まれるため、完全なバックアップとなります。ロックインはありません。データは常に 1 クリックで利用できます。
サポートされているフレームワークは何ですか?
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などの地域バリエーションを含む)。アラビア語、ヘブライ語、ウルドゥー語もリストに含まれており、右から左に書く言語も機能します。新しい言語をプロジェクトに追加するには、ダッシュボードで1クリックするだけです。
サーバーサイドレンダリングで動作しますか?
はい。Node.js SDK は AsyncLocalStorage を使用しているため、ローダー、head 関数、サーバーコンポーネントが React プロバイダーなしで翻訳できます。クライアント側では、React プロバイダーがサーバー側でレンダリングされた HTML からハイドレーションします。ドキュメントには、Next.js、Nuxt、TanStack Start のためのステップバイステップガイドがあります。
これは私のアプリを遅くしますか?
新しい文字列が初めてリクエストされたとき、APIはAIモデルを呼び出します — 短いUI文字列で約0.5秒、段落ではそれより長くかかります。その後のリクエストはすべてデータベースから提供され、これは通常のキャッシュヒットです。SDKは翻訳をローカルでもキャッシュするため、再訪問ユーザーはネットワーク遅延を感じません。同時に10人のユーザーが同じ文字列をリクエストしても、AIの呼び出しは1回だけ行われます。
サービスがダウンしたらどうなりますか?
各 SDK はローカルで翻訳をキャッシュします — ウェブでは localStorage、モバイルでは AsyncStorage、サーバーではメモリに保存されます。API にアクセスできない場合、SDK はキャッシュされた翻訳を提供します。ユーザーは最後に知られた翻訳を表示し、空の文字列が表示されることはありません。API が復帰すると、SDK は静かに更新されます。
それはどのAIプロバイダーを使用していますか?
5つのプロバイダーがサポートされています:Mistral、OpenAI、Anthropic、Google、およびOllama、Groq、TogetherなどのOpenAI互換のエンドポイント。オペレーターは、ダッシュボードまたは環境からプロバイダーとモデルを選択します。i18n-keyless.comのデフォルトはMistralです。セルフホストユーザーはローカルでOllamaを実行し、サードパーティに何も送信しません。
AI翻訳を上書きできますか?
はい。ダッシュボードの任意のセルをクリックし、正しいテキストを入力して保存します。修正は永続的です。APIは手動で設定された値を上書きすることはありません。また、APIまたはMCPサーバー経由で翻訳を上書きすることもできますので、AIコーディングエージェントが翻訳を修正できます。
i18next または他のライブラリから移行できますか?
はい。ドキュメントには、i18next、react-intl、Lokalise向けのステップバイステップの移行ガイドがあります。APIには、既存の翻訳を1つずつインポートする移行エンドポイントがあり、AI呼び出しや課金はありません。MCPサーバーには同じツールがあり、AIエージェントが移行を代行できます。
無料プランはありますか?
セルフホスト版は完全に無料で、プロジェクト数に制限はありません。Dockerイメージをインストールし、独自のAIキーを使用して、データを独自のサーバーに保管します。時間制限はなく、機能制限もありません。サーバーを運用したくない場合は、ホスト版のプランがプロジェクトごとに月額4ユーロから始まります。
ソースコードは利用可能ですか?
サーバー、ダッシュボード、DockerイメージはGitHubでElastic License 2.0の下で公開されています。すべての行を読み、コードを実行して変更することができます。SDK(React、Vue、Node、Railsなど)はMITライセンスです。唯一の制限:サードパーティにホストされたサービスとしてソフトウェアを提供することはできません。
メンテナー1人:プロジェクトが停止したらどうなりますか?
SDKはMITライセンスの下にあり、npm、PyPI、RubyGems、その他のレジストリで利用可能です。サーバーはElastic License 2.0の下で公開されており、その間のプロトコルは文書化されているため、誰でも実行、フォーク、またはサーバーを書くことができます。翻訳は常に1つのJSONエクスポートに保存されます。ホストされているサービスが停止した場合:インストール済みのアプリはキャッシュされた翻訳を引き続き提供し、新しいクライアントはソース言語にフォールバックし、SDKをAPI_URLで自身のインスタンスに向けることで全てが復元されます。失うのは、i18n-keyless.com上の新しい文字列のAI翻訳だけです。データやアプリ自体ではありません。
完全な回答をコードと共に読むコンテキストは単に偽装された鍵ではないのですか?
いいえ。各文字列にはキーが必須で、一意である必要があり、手動で管理するグローバル名前空間に存在します。コンテキストはオプションで、意味が曖昧な文字列(「Close」は窓を閉じるか、距離による「close」か)に付加され、文字列の名前ではなく意味を説明します。ほとんどの文字列にはコンテキストがありません。元のテキストが検索の基準となり、コンテキストの有無にかかわらず、2つの同一テキストに2つのコンテキストがあれば、単に2行です。
完全な回答をコードと共に読むプルリクエストでコピーをレビューできますか?
はい。ソース文字列はコード内にあり、そのためあらゆる言葉の変更は、レビュアーがプルリクエストでキー名ではなく平易な言葉で読む差分です。gitにないのは他言語への翻訳です。それはデータベース内に存在し、他の翻訳プラットフォームと同様で、ダッシュボードで確認できます。そこではセルごとの「レビュー済み」マークが、人が確認したものとAIが書いたものを区別します。またはJSONエクスポートで確認します。
完全な回答をコードと共に読むなぜオープンソースでもあるTolgeeではないのですか?
Tolgeeは、Apache 2.0ライセンスの下で動作するキーに基づく翻訳プラットフォームで、コンテキスト内編集、スクリーンショットコンテキスト、翻訳メモリを備えています。これらの機能や翻訳者をプロセスに組み込みたい場合に適しています。i18n-keylessはキーを持ちません。ロケールファイルもなく、AI翻訳がデフォルトで有効で、手動での上書きはAIが決して書き換えない仕組みです。Elastic License 2.0のサーバーにMIT SDKを搭載し、SQLiteで動作するセルフホスト型イメージを1つのコンテナで実行します。コンテキスト内修正を行うには、スクリーンショットを撮り、MCPサーバーに接続されたAIエージェントに送信します。エージェントが文字列を見つけて翻訳を上書きします。ドキュメントの比較ページでは価格が並べて表示されます。
完全な回答をコードと共に読むセルフホストかサブスクリプションか:どちら?
セルフホスト: あなた自身のサーバー上で同じDockerイメージを完全に無料で、無制限のプロジェクトと、あなた自身のAIキーと自宅のデータで利用できます。気に入りましたか?チップをください!サブスクリプション: 我々が運営し、アップデートは自動、プロジェクトごとに月額4ユーロからの固定料金です。サーバーを運用したくない場合はサブスクリプションをご利用ください。
完全な回答をコードと共に読む名前やカウントなどの動的な値をどのように扱えばよいですか?
置換オプションを使用します。プレースホルダーを含む文を書きます — 「こんにちは {name}、あなたは {count} 個のアイテムを持っています」 — そしてレンダリング時に replace で値を渡します: { "{name}": userName, "{count}": String(n) }。AI はプレースホルダーを認識し、すべての翻訳でそれを維持します。SDK は実行時に値を置換します。
複数形をどのように扱いますか?
{count} を含む形式を作成し、数値を count として渡します。API は、各言語に必要な形式(フランス語では 2 つ、ロシア語では 4 つ、アラビア語では 6 つ)を正確に保存し、Intl.PluralRules で検証された ICU 複数形メッセージを 1 つずつ保存し、SDK が適切なものを選択します。ランクには序数(1st、2nd)を追加します。自分でブランチを書くことはありません。
完全な回答をコードと共に読む性別をどのように扱えばいいですか?
select に値を渡します — select={{ gender: "female" }} — そしてモデルは各値に対して1つのバリアントを、あらゆる言語で、言語のニーズに応じて書きます。値は閉じたセットからの識別子で、変数ごとに最大10、文ごとに最大2の変数です。select と count を組み合わせることができます。名前のような開かれた値は置換のままです。
完全な回答をコードと共に読む日付、数字、通貨をどのようにフォーマットしますか?
SDK はそれらをフォーマットしません。実行時環境が行います。Intl.DateTimeFormat と Intl.NumberFormat を SDK の現在の言語で使用し、その結果を replace で文章に挿入します。一つの文章、一つの翻訳、あらゆる言語で正しい形式です。
完全な回答をコードと共に読む翻訳プロンプトをカスタマイズできますか?
いいえ、あなたがそれを行う必要はありません。プロンプトは各キーのコンテキストを読み取ります。そこでトーン、対象者、意味が決定され、同じ単語が2つの場所で異なる翻訳になる理由です。また、ダッシュボードで手動で上書きすることもできます。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日間使用されないと自動的にクリーンアップします。翻訳のタイプミス:ダッシュボードのセルを編集すると、修正が永続的になります。
完全な回答をコードと共に読む