メインコンテンツへスキップ
A representation is an alternative asset for a file stored in Box. These assets can be PDFs, thumbnails, or text extractions. Representations allow you to access content in different formats without manually converting files, such as by extracting text from documents to send to language models for processing. レプリゼンテーションは、Boxへのアップロード時またはアセットのリクエスト時に、サポートされているファイルの種類に対して自動的に生成されます。 このようなレプリゼンテーションは、fields=representationsクエリパラメータとx-rep-hintsヘッダーを使用することで、GET /files/:idエンドポイントを介して公開されます。 The workflow involves:
  1. Getting the list of available representations for a file.
  2. Checking a specific representation’s status and retrieving its url_template.
  3. Downloading the representation if available.
The Box Python SDK provides the file.get_representation_info(rep_hints) method to access these capabilities.