著者: George Curta ·
トークンシステムガイドに戻る
ドキュメント / トークンシステム / FAQ
トークンシステム — よくある質問
トークンの仕組み、コスト、残高の活用方法に関するクイック回答。
基本
- トークンとは何ですか？
- トークンは anonym.legal の利用クレジットです。分析、匿名化、復号の各操作ごとに、アカウント残高から少量が差し引かれます。各操作の前に正確なコストが表示され、成功した操作にのみトークンが消費されます。
- 課金トークンとトークン化 PII プレースホルダーの違いは何ですか？
- 同じ「トークン」という言葉ですが意味が異なります。課金トークンは操作に消費するクレジットです。トークン化 PII プレースホルダー（例：<PERSON_1>）は、匿名化時にテキスト内の実名を置き換える技術的な文字列です。プレースホルダーごとに課金されるのではなく、操作ごとに課金されます。
- 現在のトークン残高を確認するには？
- ウェブアプリでは Settings → Account へ移動します。API では、無料の /api/mcp/balance エンドポイントまたは anonym_legal_get_balance MCP ツールを呼び出します。どちらも残高、サイクル開始日、サイクル終了日を返します。
割り当てと制限
- 各プランで何トークン付与されますか？
- Free：30 日サイクルあたり 200 トークン。Basic（€3 / 月）：31 日サイクルあたり 1,000 トークン。Pro（€15 / 月）：4,000 トークン。Business（€29 / 月）：10,000 トークン。未使用トークンは翌サイクルに繰り越されません。
- 未使用トークンは次のサイクルに繰り越されますか？
- いいえ。トークンの割り当てとトップアップはどちらも各請求サイクルの終了時にリセットされます。計画的に使用し、使う直前にトップアップを購入してください。これは、予測しにくい大量のワークロードにとっては実際の制約です。コストはドキュメントのサイズとPIIの密度に応じて増えるため、大きなまたは密度の高いドキュメントが一時的に集中すると、サイクルのリセット前に割り当てを使い切る可能性があります。アップグレードするかどうかを判断する際は、単純な平均コストではなく、余裕を持たせて予算を見積もってください。
コストと見積もり
- テキスト 1 ページの分析にかかるコストは？
- コストはテキストの長さと検出された個人データに応じて増えます。短い契約書は数トークン、個人データの表が密集した長い文書ははるかに多くなります。一般的な文書サイズの現在のコストとインタラクティブな計算機は、トークンシステムのページ（/docs/token-system）にあります。正確なコストはウェブアプリの各操作ボタンの横と、APIの無料見積もりエンドポイントで確認できます。
- 操作実行前にコストを見積もるには？
- 2 つの方法があります。ウェブアプリでは、各操作ボタンの横にコストのプレビューが表示されます。API では、無料の anonym_legal_estimate_cost MCP ツールを使用してください。操作を実行せずに正確な控除額を返します。
- トークンコストの目安は？
- 分析コストは、テキストの長さ（1,000文字単位）、有効なエンティティタイプの数、検出数で決まります。匿名化では、オペレーターごとと暗号化するエンティティタイプごとに少額が加算されます。差し引かれたトークン数は各結果に表示されます。実際にAnonymizeをクリックした場合のコストは、分析と適用の合計です。復号は最も安い操作です。現在のレートでの具体例は、トークンシステムのページ（/docs/token-system）にあります。
- オペレーターを変えるとコストが変わりますか？
- 置換・墨消し・マスク・ハッシュのコストは、同じ入力に対してすべて同じです。プライバシー目標に合うものを選んでください。encryptはコスト面での例外で、適用ステップにエンティティごとの項を加えるため、小さな入力では明らかに高くなります（大きな入力では差が小さくなります）。元のデータを復元する必要がない場合は、encrypt以外のオペレーターを選んでください。
- テキストの言語によってコストは変わりますか？
- コストは文字数と検出されたエンティティによって決まり、言語には依存しません。サポートされている 48 言語のいずれかの短い文章は、わずかなトークンしかかかりません。
エッジケース
- タスクの途中でトークンが不足した場合はどうなりますか？
- 次の操作で 402 Payment Required レスポンスが返され、正確な不足量が示されます。有料プランの場合はすぐにトップアップを購入するか、サイクルのリセットを待つことができます。
- 失敗した操作にはトークンがかかりますか？
- いいえ。トークンは操作が成功した後にのみ差し引かれます。バリデーションエラー、サーバーエラー、拒否されたリクエストはトークンを消費しません。
- AI エンティティ作成の料金はどのように機能しますか？
- AI でカスタムエンティティ認識器を作成すると、リクエストごとに一律 50 トークンが現在のサイクル残高から差し引かれます。コストは各呼び出し前に表示され、事前通知により変更される場合があります。
トップアップと有効期限
- サイクル中にトークンを追加購入できますか？
- はい — Basic、Pro、Business プランではトップアップを購入できます。レート：Basic €1 = 250 トークン、Pro €1 = 300 トークン、Business €1 = 350 トークン。Free プランのユーザーはトップアップを有効にするためにアップグレードが必要です。
- トップアップトークンは有効期限がありますか？
- はい。トップアップトークンは月次割り当てと同様に、次のサイクルリセット時に有効期限が切れます。繰り越しはされません。