始める前に
- Docker がインストールされ、実行されていること
- 解析対象の PDF または画像ファイル
- FineParser の License file。fineparser.ai でプランに登録すると、
.fineparserlicenseファイルが発行されます。License とプランを参照してください。 - ABBYY の License server への外向き通信。ネットワークで送信が制限されている場合は、まずネットワーク要件に記載された範囲を許可してください。
1
Licenseを取得する
fineparser.ai でプランに登録します。Free プランでは月あたり 1,000 ページまで利用できます。アカウントごとに
.fineparserlicense ファイルが 1 つ発行されます。2
FineParser を起動する
License file の内容を このボリュームには解析結果が保存されます。指定しない場合、コンテナーの終了とともに結果も失われます。次に、License が受け付けられたことを確認します。
FINEPARSER_LICENSE_DATA 環境変数に渡し、ポート 8080 を公開します。Apple シリコン Mac などの ARM ホストでは、上記のコマンドに
--platform linux/amd64 を追加してください。現時点でイメージは amd64 のみに対応しており、エミュレーションで動作するため速度は低下します。ARM での実行を参照してください。ready が false の場合は、レスポンスの detail フィールドにその理由が示されます。License の確認を参照してください。3
Document を送信する
4
完了を待つ
status が successful になるまで、ID を使って job をポーリングします。status が failed の場合は、レスポンスにその理由を示す error が含まれます。5
結果をダウンロードする
file の値を /jobs/ の後ろに付け加えます。doclang を json または txt に置き換えます。次のステップ
REST API
送信、ポーリング、ダウンロード、そしてすべてのレスポンスコード。
出力形式
DocLang、JSON、またはプレーンテキスト。
Configuration
Recognition mode、Languages、ポートの設定。
AI コーディングエージェント
Claude Code や Codex からこのドキュメントを参照できるようにします。
