クイック スタート: 同期 Content Understanding 操作を使用する

同期操作は、抽出されたコンテンツをすぐに必要とする対話型のシナリオや、処理中に一時的なサービス側ストレージを回避したい場合に最適です。 これらの操作は、メモリ内の入力を処理し、応答で構造化されたコンテンツを直接返します。 結果を確認するための別の要求は送信されません。 このパブリック プレビューでは、 prebuilt-read アナライザーと prebuilt-layout アナライザーで同期操作を使用できます。

同期操作では、非同期操作と同じドキュメント ファイル形式がサポートされます。 ファイル サイズ、ページ、文字、およびページ範囲の制限については、「 Content Understanding サービスの制限」を参照してください。

前提条件

このクイック スタートでは、 Content Understanding REST API で同期読み取りとレイアウト操作を使用して、小さなドキュメントや画像から構造化コンテンツを抽出する方法について説明します。 prebuilt-readアナライザーとprebuilt-layout アナライザーは、次の 2 つの同期操作をサポートします。

  • analyzeInline は、URL を入力コンテンツとして受け取ります。
  • analyzeBinaryInline は、バイナリ ファイルを入力コンテンツとして受け取ります。

Read を使用して画像からテキストを抽出する

次の要求は、画像をバイナリ データとして同期読み取り操作 (prebuilt-read:analyzeBinaryInline) に送信します。 {your-resource-endpoint}、{your-subscription-key}、ローカル ファイルパスを実際の値に置き換えます。

curl --request POST \
  --url 'https://{your-resource-endpoint}/contentunderstanding/analyzers/prebuilt-read:analyzeBinaryInline?api-version=2026-06-01-preview' \
  --header 'Content-Type: application/octet-stream' \
  --header 'Ocp-Apim-Subscription-Key: {your-subscription-key}' \
  --data-binary '@D:\\Demo\\InsuranceCard.png'

応答には、画像から抽出されたテキストと位置情報が含まれます。 これは同期操作であるため、応答には分析結果が直接含まれます。 Operation-Location値をコピーしたり、結果をポーリングしたりする必要はありません。

詳細については、「 コンテンツ アナライザー - バイナリの分析」を参照してください。

レイアウトを使用してドキュメント構造を抽出する

次の要求は、同期レイアウト操作にドキュメント URL を送信します。 {your-resource-endpoint} と {your-subscription-key} を独自の値に置き換えます。 URL には、Content Understanding リソースからアクセスできる必要があります。

curl --request POST \
  --url 'https://{your-resource-endpoint}/contentunderstanding/analyzers/prebuilt-layout:analyzeInline?api-version=2026-06-01-preview' \
  --header 'Content-Type: application/json' \
  --header 'Ocp-Apim-Subscription-Key: {your-subscription-key}' \
  --data '{
    "inputs": [
      {
        "url": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/rest-api/layout.png"
      }
    ]
  }'

応答には、テーブル、セクション、図、書式設定、ハイパーリンク、署名など、抽出されたコンテンツとドキュメント構造が含まれます (サポートされている場合)。 応答には、操作の使用状況情報も含まれます。

詳細については、「 コンテンツ アナライザー - 分析」を参照してください。

同期操作と非同期操作のいずれかを選択する

アプリケーションで結果がすぐに必要な場合、入力が同期制限内に収まる場合、またはメモリ内のドキュメントを処理することがシナリオにとって重要な場合は、同期操作を使用します。 より大きな入力または実行時間の長い分析には、非同期操作を使用します。 非同期の例については、「 クイック スタート: Content Understanding REST API を使用する」を参照してください。

次のステップ

  • Last updated on