翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Rekognition のイメージおよびビデオオペレーションについて
Amazon Rekognition には、画像分析とビデオ分析用の 2 つの主要なAPIセットが用意されています。
-
Amazon Rekognition Image: これはイメージを分析するためにAPI設計されています。
-
Amazon Rekognition Video : これは、保存された動画とストリーミング動画の両方を分析することにAPI重点を置いています。
どちらも、顔やオブジェクトなどのさまざまなエンティティを検出APIsできます。サポートされている比較タイプと検出タイプを包括的に理解するには、「」の「」セクションを参照してくださいRekognition の分析タイプを理解する。
Amazon Rekognition Image のオペレーション
Amazon Rekognition Image オペレーションは同期です。入力とレスポンスは JSON形式です。Amazon Rekognition Image オペレーションでは、.jpg 形式または .png 形式の入力イメージを分析します。Amazon Rekognition Image オペレーションに渡されたイメージは、Amazon S3 バケットに保存できます。を使用していない場合はCLI、Base64 AWS でエンコードされたイメージのバイトを Amazon Rekognition オペレーションに直接渡すこともできます。詳細については、「イメージの使用」を参照してください。
Amazon Rekognition Video オペレーション
Amazon Rekognition Video は、Amazon S3 バケットに保存されているか、Amazon Kinesis Video Streams を介してストリーミングされた動画の分析APIを容易にします。
保存されたビデオオペレーションの場合は、次の点に注意してください。
-
オペレーションは非同期です。
-
分析は「開始」オペレーションで開始する必要があります (保存されている動画で顔を検出するStartFaceDetection場合など)。
-
分析の完了ステータスは Amazon SNSトピックに発行されます。
-
分析の結果を取得するには、対応する「取得」オペレーション (例: GetFaceDetection) を使用します。
-
詳細については、「保存済みビデオ分析の使用」を参照してください。
ストリーミングビデオ分析の場合:
-
機能には、Rekognition Video コレクションでの顔検索とラベル (オブジェクトまたは概念) 検出が含まれます。
-
ラベルの分析結果は、Amazon SNSおよび Amazon S3 通知として送信されます。
-
顔の検索結果は Kinesis データストリームに出力されます。
-
ストリーミングビデオ分析の管理は、Amazon Rekognition Video ストリームプロセッサを介して行われます (例: を使用してプロセッサを作成するCreateStreamProcessor)。
-
詳細については、「ストリーミングビデオイベントの使用」を参照してください。
各ビデオ分析オペレーションでは、分析中のビデオに関するメタデータのほか、ジョブ ID とジョブタグが返されます。ビデオのラベル検出やコンテンツモデレーションなどのオペレーションでは、タイムスタンプまたはラベル名でソートしたり、タイムスタンプまたはセグメント別に結果を集計したりできます。
非ストレージ型およびストレージ型のオペレーション
Amazon Rekognition オペレーションは次の種類に分類されます。
-
非ストレージAPIオペレーション – これらのオペレーションでは、Amazon Rekognition は情報を保持しません。入力イメージやビデオを指定すると、オペレーションで分析が実行されてその結果が返されますが、Amazon Rekognition によって情報は保存されません。詳細については、「非ストレージ型オペレーション」を参照してください。
-
ストレージベースのAPIオペレーション – Amazon Rekognition サーバーは、検出された顔の情報をコレクションと呼ばれるコンテナに保存できます。Amazon Rekognition には、顔の一致について保持されている顔情報を検索するために使用できる追加のAPIオペレーションが用意されています。詳細については、「ストレージベースのAPIオペレーション」を参照してください。
AWS SDK または HTTPを使用して Amazon Rekognition APIオペレーションを呼び出す
Amazon Rekognition APIオペレーションは、 を使用するか、 を使用してAWSSDK直接呼び出すことができますHTTP。そうしない理由がない限り、常に AWS を使用する必要がありますSDK。このセクションの Java の例では、 AWS SDKを使用します。Java プロジェクトファイルは提供されませんが、AWSToolkit for Eclipse を使用して Java を使用してAWSアプリケーションを開発できます。
このセクションの NETの例は、 を使用しますAWS SDK for .NET。を使用してAWSアプリケーションAWS Toolkit for Visual Studioを開発できますNET。これには、アプリケーションのデプロイとサービスの管理に役立つテンプレートと AWS Explorer が含まれています。
このガイドのAPIリファレンスでは、 を使用した Amazon Rekognition オペレーションの呼び出しについて説明しますHTTP。Java に関する参考情報については、「AWS SDK for Java」を参照してください。
使用できる Amazon Rekognition サービスエンドポイントについては、AWS「リージョンとエンドポイント」を参照してください。
を使用して Amazon Rekognition を呼び出す場合はHTTP、 POSTHTTPオペレーションを使用します。