アカウント設定とAPIの動作
アカウントの一部の動作は一度だけ設定されます。そのほとんどはWeb アプリのプロフィール設定ページで行い、1つの例外（下記のモデルティア）は ImageToTable.aiチームのみが設定します。このAPIを通じて設定することはありません。このページでは、そのような各設定がv1でどのように動作するかを正確に説明します。APIが無条件に従うものと、リクエストごとに上書きできるものがあります。これは意図的に個別のエンドポイントドキュメントに分散させていません。1つのエンドポイントのリファレンスページだけを読むと見落としがちな横断的動作を、ここにまとめているからです。
一般的なルール
v1はアカウントの現在の設定を直接読み取って適用します。独立したAPIレイヤーの設定システムはなく、（下記の意図的な1つの例外を除き）単一リクエストに対してアカウント設定を上書きする方法もありません。これは意図的な設計です。同じ動作を設定する場所を2つ（Webアプリと並行するAPI設定）維持すると、必然的に同期がずれてしまいます。目標は、処理を開始したのがWebアプリ、このAPI、Google Sheetsアドオンのいずれであっても、同じアカウントが同じように動作することです。
設定とAPIでの動作
| 設定 | Webアプリでの動作 | v1 APIでの動作 | リクエストごとに上書き可能？ |
|---|---|---|---|
bbox自動アノテートauto_annotate_bbox | アカウントレベルのトグルです。オンにすると、完了したすべての抽出で、有料のbboxアノテーションパスが自動的にトリガーされます。 | 厳密に従います — v1を通じて作成・処理されたバッチは、このトグルに例外なく従います。オンになっている場合、自分でPOST /documents/{document_id}/bboxを呼び出さなくても、bboxアノテーションの請求が発生することがあります。 | いいえ。リクエストレベルでスキップまたは強制する方法はありません。 |
処理品質thinking_type | 処理の速度/品質レベルを選択するアカウントレベルの設定です。 | 上記ルールの唯一の例外です。POST /batches/{batch_name}/processでqualityを省略すると、アカウントの現在の設定にフォールバックします — Webアプリと同じ動作です。ただし、そのリクエストでquality: "fast"またはquality: "high"を渡すことで、その呼び出しに限り上書きできます。 | はい — このページでリクエストごとに上書きできる唯一の設定です。 |
データ保持auto_delete / auto_delete_after | 処理後N日後に元画像を自動削除するためのアカウントレベルの設定です。 | 厳密に従います — v1を通じて作成されたドキュメントは、Webアプリを通じてアップロードされたものと同じ保持ポリシーの対象となります。 | いいえ。 |
| 処理モード (内部 rec_mode、modeとして公開) | Webアプリは現在、テーブル形式の抽出と文書全体のWord変換をサポートしています。 | v1は現在、mode=table（構造化フィールド抽出）のみをサポートしています。文書全体の変換は計画されていますが、APIではまだ利用できません。 | まだ該当なし — 選択できる値は1つだけです。より多くのモードがリリースされた場合、これは既存の値の動作変更ではなく、純粋な追加となります。 |
モデルティアmodel_tier | アカウントの抽出がどのAIモデルで実行されるか、および処理された各ドキュメントのコストを示します。Standard（全アカウントのデフォルト、1クレジット）、Advanced（3クレジット）、Premium（6クレジット）のいずれかです。ImageToTable.aiチームによって割り当てられます。アカウント設定にティア選択機能はありません。 | 厳密に従います。POST /batches/{batch_name}/processは、アカウントの現在のティアのコストに応じてクレジットを差し引きます。単一の呼び出しで異なるティアをリクエストする方法はありません。ティアはそのエンドポイントが呼び出された時点で固定されます。すでにキューに入っているドキュメントは、アカウントのティアがそのドキュメントの処理完了前に変更された場合でも、課金された時点のティア（およびクレジットコスト）を維持し、後でキャンセルまたは失敗した場合も同じ固定されたティアで返金されます。非Standardの課金がクレジット台帳にどのように表示されるかについては、アカウント使用量を参照してください。 | いいえ。このページの他のすべての行よりも厳格です。Webアプリのセルフサービスアカウント設定ですらなく、リクエストごとに読み取ってミラーリングするものはありません。v1にはどこにもティアパラメータはありません。 |
リクエストレベルの上書きを追加しないのはなぜ？
bbox自動アノテートと保持ポリシーは、呼び出しごとの設定ではなくアカウントレベルのガバナンスとして扱われます。これらは「すべてに対してオン、またはすべてに対してオフ」というスイッチであり、1つのAPI呼び出しがアカウントの標準設定から静かに逸脱することを許すと、この設計が回避しようとしている「2つの設定ソースによるずれ」という問題がまさに発生するからです。qualityは異なります。どの速度・品質ティアが適切かは呼び出しごとに本当に変わり得るため（このバッチは早く処理する必要がある、あのバッチは最大の精度が必要など）、ガバナンス設定ではなく運用上の選択として扱われ、唯一の上書き項目として開放されています。
モデルティアは「リクエストごとの上書きなし」よりもさらに一歩進んでいます。そもそもセルフサービスのアカウント設定ですらありません。このページの他の行はプロフィール設定ページで自分で設定し、v1はそれをそのまま反映するだけですが、モデルティアはアカウントが実際に実行しているワークロードに基づいてImageToTable.aiチームが割り当てるレートであり、各ドキュメントのコストに直接影響するためです。これを呼び出し側がリクエストごとに（あるいはアカウントごとに、支援なしで）切り替えられるものとして公開すると、1つの誤った値が確認ステップなしにバッチの請求額を3倍または6倍に静かに増やす可能性があります。これは、このページの他の部分が回避している同じずれ問題の「クレジットは実際のお金」バージョンです。