- を使用して、複数ページのPDFを、自分で定義したページ範囲ごとのセグメントに分割する。
- を使用して、自然言語による指示をBoxに解釈させ、ページのグループ化方法を決定する。
ユースケースの例
前提条件
使用を開始する前に、ガイドに記載されている手順に従って、Platformアプリを作成し、アクセストークンを生成してください。 以下も必要です。- Boxにすでに格納されているソースPDF
- アプリが書き込み可能なBox上の保存先フォルダ
APIバージョン
Boxドキュメント分割のエンドポイントに対するすべてのリクエストでは、box-versionヘッダーを2026.0に設定して、有効なAPIバージョンを指定する必要があります。
詳細については、を参照してください。
分割タイプ
送信するsplit_typeによって、残りのリクエスト本文が決まります。
スマート分割はAIユニットを消費します。Boxは、4ページ処理するごとに1 AIユニットを消費します。
Boxドキュメント分割の仕組み
Boxドキュメント分割は非同期に動作し、以下の2つのステップを実行します。POSTリクエストを/2.0/document_splitsに送信して分割ジョブを作成します。レスポンスにはジョブIDが含まれています。- そのIDを使用して、
GETリクエストを/2.0/document_splits/{document_split_id}に送信し、状態および生成されたファイルを取得します。
分割ジョブを作成する
リクエスト本文の構造はどちらの分割タイプも同じです。違いはsplit_inputの内容のみです。
リクエストの詳細な例については、またはのガイドを参照してください。
レスポンスには、分割ジョブのIDが含まれています。
分割ジョブの状態と結果を取得する
POSTのレスポンスで返されたジョブIDを使用して、分割の詳細を取得します。
cURL
split_definitionには、Boxがプロンプトから導き出したページ範囲が表示されます。split_definitionを参照することで、プロンプトによって期待どおりのグループ化が行われたかどうかを確認できます。