著者: George Curta ·
画像の墨消し — 使い方ガイド
スキャン、写真、スクリーンショット内の個人情報を検出して覆い隠します。このガイドでは、アップロード・分析・墨消し・ダウンロードのワークフロー、サイズおよびフォーマットの制限、OCR対応言語、そして背後にあるAPI呼び出しについて説明します。
ワークフロー：アップロード、分析、墨消し、ダウンロード
Webアプリを使用する場合でも、APIを直接呼び出す場合でも、MCPサーバー経由で anonym_legal_redact_image ツールを呼び出す場合でも、すべての画像は同じ4つのステップを経ます。
1. アップロード
PNGまたはJPGファイルを選択します。アプリは、サーバーに何も送信する前に、ファイルの種類とサイズをプランのアップロード上限と照合します。
2. 分析
OCR（Tesseract）が画像内のテキストを読み取り、各テキストの位置を記録します。抽出されたテキストは、文書処理と同じPII検出エンジンを通過し、検出されたエンティティとその位置が返されます — この時点ではまだ何も墨消しされていません。
3. 墨消し
modeを「redact」に設定してリクエストを再実行すると、検出されたすべての領域が画像のピクセル上に直接描画された黒塗りボックスで覆われます。これは一方向の視覚的な墨消しであり、復元可能な暗号化ではありません。
4. ダウンロード
墨消しされた画像は、ローカルに保存できるファイル（PNGまたは元のコンテンツタイプ）として返されます — レスポンス送信後、サーバー上には何も保持されません。
サイズおよびピクセルの制限
- PNGとJPG（JPEG）のみに対応しています。TIFF、BMP、WebP、GIFなどその他のラスターフォーマットには現在対応していません。
- 画像はサーバー側で20 MBが上限です。プランによってはこれより低い上限が設定されている場合があります — Basicプランのアップロード上限は5 MB（Proは10 MB、Businessは20 MB）です。無料プランでは画像の墨消しは一切利用できません。
- 総解像度（幅×高さ）は150メガピクセルが上限です。この上限を超えるアップロードは、処理前に拒否されます。
OCR対応言語
OCRはTesseractで動作します。APIのlanguageフィールドはISO 639-1コード（デフォルトは英語の「en」）を受け付け、Tesseractの言語パックに対応付けられます — ドイツ語、フランス語、スペイン語、イタリア語、ポルトガル語、オランダ語、ポーランド語、ロシア語、ウクライナ語、アラビア語、ヘブライ語、ヒンディー語、日本語、韓国語、中国語、タイ語、ベトナム語、トルコ語など、約36の言語が対応付けられています。実際に利用できるかどうかは、OCRホストにインストールされているTesseractパックによって異なります。利用できない言語は英語にフォールバックします。
APIリファレンス
画像の墨消しは、Webアプリを経由しない連携のためにAPI経由で直接利用できるほか、Claudeなどの MCP クライアント向けに MCP サーバー経由で anonym_legal_redact_image ツール（モード「analyze」または「redact」）としても利用できます。
POST /api/presidio/imageAuthentication: Authorizationヘッダーに Bearer トークン（APIトークンまたは認証済みセッション。テキスト分析エンドポイントと同様）を指定して認証します。有効なトークンがないリクエストは401を返します。
Request body: multipart/form-data形式のボディを送信します。必須フィールド：file（PNGまたはJPG画像）とmode（「analyze」または「redact」）。任意フィールド：language（ISO 639-1のOCR言語コード、デフォルトは「en」）、entities（検出対象を絞り込むエンティティタイプのJSON配列）、score_threshold、fill_color（redactモードのみ、デフォルトは「black」）, operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: analyzeモードでは、レスポンスはJSONで、検出されたエンティティ（種類、テキスト位置、信頼度スコア）とtokens_chargedフィールドが返されます。redactモードでは、レスポンスは墨消しされた画像そのもの（バイナリ、Content-Typeはimage/pngまたは元のタイプ）であり、トークンコストはX-Tokens-Chargedヘッダーで返されます。
よくある質問
どの画像フォーマットに対応していますか？
PNGとJPG（JPEG）のみです。TIFF、BMP、WebP、GIFなどその他のラスターフォーマットには現在対応していません。
サイズと解像度の制限はどのくらいですか？
20 MB、総解像度150メガピクセルが上限です。さらにプランごとのアップロード上限（Basicは5 MB、Proは10 MB、Businessは20 MB）が適用されます。
画像の墨消しには有料プランが必要ですか？
はい。画像の墨消しにはBasicプラン以上が必要です。無料プランはテキストの匿名化のみに対応しています。
墨消しは復元可能ですか？
いいえ。墨消しは、検出された領域を画像のピクセル上に直接不透明な黒塗りボックスで覆う、一方向の視覚的な処理であり、テキスト匿名化ツールが提供するような復元可能な暗号化ではありません。
Webアプリを使わずに、直接APIを呼び出すにはどうすればよいですか？
Authorizationヘッダーに Bearer トークンを指定し、fileとmode（「analyze」または「redact」）を含むmultipart/form-data形式のボディで、/api/presidio/imageにPOSTリクエストを送信します。完全なフィールド一覧とレスポンス形式については、上記のAPIリファレンスセクションをご覧ください。
Limitations / Important note
- OCR-based text extraction is probabilistic; low-quality scans and handwriting lower detection recall.
- Redaction is a visual, one-way black box over the detected region — not reversible encryption.
- This page is informational and is not legal advice.