# API概要 — ドキュメント、バッチ、テンプレート、フィールド > ImageToTable.ai v1 APIは、請求書、領収書、その他の書類の写真、スキャン、PDFを構造化JSONに変換します。このページでは、4つの核となる概念（ドキュメント、バッチ、テンプレート、フィールド）と、それらの連携について説明します。 ImageToTable.aiのv1 APIは、請求書、領収書、銀行取引明細書、注文書などの実在する書類の写真、スキャン、PDFから構造化データを抽出し、JSONで返します。このページでは、これらのドキュメントの基礎となる4つのリソースを紹介します。 ## 核となる概念 4つのリソースがAPIの全範囲をカバーしています。[リファレンス](/developers/reference/)セクションのすべてのエンドポイントは、これらのいずれかを操作します。 - **ドキュメント** — 処理された1ページを表します。画像をアップロードするか、PDFページをアップロードすることで作成されます（複数ページのPDFをアップロードすると、ページごとに*複数の*ドキュメントが生成されます。詳細は[ドキュメントリファレンス](/developers/reference/documents)を参照）。ドキュメントはステータスライフサイクル（`queued` → `processing` → `succeeded` / `failed` / `canceled`）を経て進行します。詳細は[非同期タスクモデル](/developers/guides/async-model)ガイドで説明しています。 - **バッチ** — 一緒にアップロードおよび処理されるドキュメントの名前付きグループです。各ドキュメントは、`batch_name`（ユーザーが指定するか、アップロード時にAPIが自動生成する文字列）で識別される、1つのバッチに属します。処理の開始、ステータスの確認、結果の取得はバッチレベルで行います。 - **テンプレート** — 毎回抽出したいフィールドのセットを保存して再利用できるものです（例：`invoice_number`、`vendor_name`、`total_amount`を含む「仕入先請求書」テンプレート）。テンプレートを使用すると、`process`呼び出しのたびに同じフィールドを再宣言する手間が省けます。 - **フィールド** — ドキュメントから抽出したい単一の名前付きの値です（請求書番号、日付、明細金額など）。フィールドはテンプレート上に配置するか、テンプレートを作成せずに単一の`process`呼び出しでインラインで1回限り宣言することもできます。 ## 各要素の関係 バッチに1つ以上のファイルをアップロードすると、各アップロードがドキュメントになります。その後、バッチの処理を開始し、取得したいフィールドをAPIに指定します。保存済みのテンプレートを指定するか、リクエスト本文にフィールドを直接列挙します。どちらも指定しない場合、APIは適切な列を自動的に推論します。処理が完了したら、バッチの結果を取得します。各ドキュメントには、フィールド名をキーとする`line_items`オブジェクトの配列が含まれています。 ## JSONが基本形式です JSONは、すべてのエンドポイントで完全にサポートされている標準のレスポンス形式です。Excel（`.xlsx`）およびWord（`.docx`）へのエクスポートは、同じデータに対する便利なダウンロード機能として存在します（[バッチリファレンス](/developers/reference/batches)を参照）。これらは別のデータモデルではなく、API連携はJSON形式に基づいて構築する必要があります。 ## 認証とアクセス すべてのv1リクエストは、`Authorization: Bearer `として送信されるAPIキーで認証されます。同じブラウザからログインしている場合でも、セッションクッキーによるフォールバックはありません。v1 APIは有料プラン（Basic以上、Growth以上のチームを含む）で利用可能です。無料プランのアカウントには`plan_required`エラーが返されます。APIキーの確認場所については、[環境設定](/developers/environment-setup)を参照してください。 ## 次のステップ 最初の呼び出しを行う準備はできましたか？[クイックスタート](/developers/quickstart)では、キーの取得、ドキュメントのアップロード、処理の開始、結果の取得までを約5分で説明しています。全エンドポイントの一覧は、[APIリファレンス](/developers/reference/)を参照してください。AIコーディングアシスタントを使用して連携する場合は、[OpenAPI 3.1仕様](/static/openapi/imagetotable-v1.yaml)を直接指定してください。これはすべてのリファレンスページの背後にある同じスキーマであり、機械可読な形式で一貫しています。 --- Source: https://imagetotable.ai/ja/developers/