画像から表 | FreeAIOCR

POST /api/v1/image-to-table

POST /api/v1/image-to-table に multipart image を1枚送信します。format は json（既定）、csv、xlsx のみ。YOUR_API_KEY と table.png を置き換えてサーバーから実行してください。共通のBearer 認証を使用します。

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

成功した JSON には request_id、usage、billing、tables（各項目は {title, html}）が含まれます。HTML は安全に整形された表マークアップです。Table N は元画像の見出しではなく代替表示名です。生の認識テキストは返しません。

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "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"
  },
  "tables": [
    {
      "title": "Sales",
      "html": "<table><tbody><tr><th>Item</th><th>Qty</th></tr><tr><td>Notebook</td><td>0012</td></tr></tbody></table>"
    }
  ]
}

同じ画像と Idempotency-Key のまま形式を切り替えると、再認識・再課金されません。

curl --silent --show-error --fail --output tables.csv --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-table?format=csv' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-table-request-0001' \
  -F 'image=@table.png'

curl --silent --show-error --fail --output tables.xlsx --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-table?format=xlsx' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-table-request-0001' \
  -F 'image=@table.png'

CSV：表1つなら通常の UTF-8 CSV、複数なら空行区切りで各部分が # Table N: Title から始まります。複数表の出力は単一の標準 CSV ではありません。読み込む前に分割してください。数式として解釈される文字列は安全化します
XLSX：表ごとに別の Table N シートを作成し、セル結合を保持します。数値や先頭のゼロを含めすべて文字列で保存するため、計算前に確認してください
入力：API は PNG、JPEG、WebP の1枚（最大 10 MB）のみ。Web ツールは HEIC、HEIF、BMP なども受け付けますが、API では非対応です。PDF、複数ページ、一括処理、複数ファイルは非対応。1枚の画像に複数の表を含めることはできます

表特有のエラーと共通ルール

有効な表がない場合は精算前に 422 no_tables が返され、予約額が解除され課金されません。認識・精算後に CSV/XLSX の出力が失敗すると 503 export_failed と recognition_succeeded: true が返されます。再取得可能な期間内は同じ画像、アカウント、Idempotency-Key で format=json を再試行してください。結果や請求が不明な間は新しい操作を作らないでください。エラーは request_id、error.code を含む JSON で、Cache-Control: no-store が付きます。成功したファイルの応答には X-Request-Id、X-OCR-Charged-USD、X-OCR-Price-Version が付きます。

同じ操作で format を変えても再認識・再課金されません。完了結果は 24 時間以内に再取得でき、再取得も回数制限に算入されます。文字 API と表 API で同じキーを使うと 409 idempotency_conflict です。API 残高はウェブのポイントとは別です。共通の料金と予約、リクエスト制限、冪等性と再試行を参照してください。