API 概要

FreeAIOCR API で画像から文字や表を抽出できます。各 API リファレンスで対応入力や出力形式を確認してください。

クイックスタート

アカウントのメールアドレスを確認する
キー設定で API キーを作成する。キーは一度だけ表示されるため、安全に保存する
API 残高に $5 を入金する。残高は全キーで共有され、サイトの購読とは別で期限はない
サーバーから下記のコマンドを送信し、YOUR_API_KEY と document.png を置き換える
認識結果、token 使用量、料金をレスポンスで確認する

認証

Authorization: Bearer YOUR_API_KEY

HTTPS の Bearer 認証を使用し、キーはサーバーで保護してください。ブラウザーからのクロスオリジン API 呼び出しは非対応です。公開コードにキーを埋め込まないでください。

POST と Bearer キーを使い、image フィールドに画像を1枚だけ送信します。下の YOUR_API_KEY と document.png を置き換えてください。multipart Content-Type と境界は cURL に任せます。クエリは任意の format のみ指定できます。追加フィールドやモデル設定は受け付けません。サーバーから呼び出してください。ブラウザーのクロスオリジン呼び出しは非対応です。キーを公開しないでください。

curl --silent --show-error --include --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-text' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-request-0001' \
  -F 'image=@document.png'

レスポンスの確認

以下の JSON は例です。実際の認識結果や token 使用量は画像によって変わります。

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "text": "# Document title\n\nRecognized paragraph.\n\n| Item | Count |\n| --- | --- |\n| Books | 12 |",
  "usage": {
    "input_tokens": 2000,
    "output_tokens": 4000
  },
  "billing": {
    "currency": "USD",
    "price_version": "2026-10-26-v1",
    "base_usd": "0.002000000",
    "input_overage_usd": "0.000000000",
    "output_overage_usd": "0.002400000",
    "total_usd": "0.004400000"
  }
}

安全な再試行

通信エラー時は元の Idempotency-Key と画像をそのまま使います。新しい操作には新しい一意のキーが必要です。元の結果や料金が未確定なら別の操作を開始しないでください。詳しくは再試行の手順をご覧ください。

共通ガイドは画像からテキストと画像から表に適用されます。入力、形式、固有のエラーは各 API リファレンスをご確認ください。

API を選択

クイックスタート

認証

最初のリクエスト

レスポンスの確認

安全な再試行