翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Rekognition の画像およびビデオオペレーションについて
Amazon Rekognition には、画像分析用とビデオ分析用に 2 つの主要な API セットが用意されています。
+ Amazon Rekognition Image: この API は画像の分析用に設計されています。
+ Amazon Rekognition Video: この API は保存済みビデオとストリーミングビデオの両方の分析に重点を置いています。
どちらの API でも、顔や物体などのさまざまな要素を検出できます。サポートされている比較と検出の両タイプを包括的に理解するには、[Rekognition の分析タイプについて](how-it-works-types.md) に関するセクションを参照してください。
## Amazon Rekognition Image のオペレーション
Amazon Rekognition Image のオペレーションは同期的に行われます。入力およびレスポンスは JSON 形式です。Amazon Rekognition Image オペレーションでは、.jpg 形式または .png 形式の入力イメージを分析します。Amazon Rekognition Image オペレーションに渡されたイメージは、Amazon S3 バケットに保存できます。AWS CLI を使用しない場合は、Base 64 エンコードされた画像のバイトを Amazon Rekognition オペレーションに直接渡すこともできます。詳細については、「[画像の操作](https://docs.aws.amazon.com/rekognition/latest/dg/images.html)」を参照してください。
## Amazon Rekognition Video オペレーション
Amazon Rekognition Video API により、Amazon S3 バケットに保存されたビデオまたは Amazon Kinesis Video Streams を介してストリーミングされるビデオの分析が容易になります。
保存済みビデオのオペレーションについては、以下の点に注意してください。
+ オペレーションは非同期的に実行されます。
+ 分析は「Start」オペレーション (例えば、保存済みビデオ内の顔検出の場合は [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html)) で開始する必要があります。
+ 分析の完了ステータスは Amazon SNS トピックに発行されます。
+ 分析結果を取得するには、対応する「Get」オペレーション (例えば、[GetFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetFaceDetection.html)) を使用します。
+ 詳細については、「[保存済み動画分析での作業](https://docs.aws.amazon.com/rekognition/latest/dg/video.html)」を参照してください。
ストリーミングビデオ分析の場合:
+ Rekognition Video コレクションでの顔検索やラベル (物体や概念) 検出などの機能があります。
+ ラベルの分析結果は Amazon SNS と Amazon S3 の通知として送信されます。
+ 顔検索の結果は Kinesis データストリームに出力されます。
+ ストリーミングビデオ分析の管理は、Amazon Rekognition Video ストリームプロセッサを介して行われます (例えば、[CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html) を使用してプロセッサを作成します)。
+ 詳細については、「[ストリーミングビデオイベントの操作](https://docs.aws.amazon.com/rekognition/latest/dg/streaming-video.html)」を参照してください。
各ビデオ分析オペレーションでは、分析中のビデオに関するメタデータのほか、ジョブ ID とジョブタグが返されます。ビデオに対するラベルの検出やコンテンツのモデレーションなどのオペレーションでは、タイムスタンプまたはラベル名でソートしたり、タイムスタンプまたはセグメント別に結果を集計したりできます。
## 非ストレージ型およびストレージ型のオペレーション
Amazon Rekognition オペレーションは次の種類に分類されます。
+ [**非ストレージ型 API オペレーション**] - このオペレーションでは、Amazon Rekognition によって情報は保存されません。入力イメージやビデオを指定すると、オペレーションで分析が実行されてその結果が返されますが、Amazon Rekognition によって情報は保存されません。詳細については、「[非ストレージ型オペレーション](how-it-works-storage-non-storage.md#how-it-works-non-storage)」を参照してください。
+ [**ストレージ型 API オペレーション**] - Amazon Rekognition サーバーは、検出された顔情報をコレクションと呼ばれるコンテナに保存できます。Amazon Rekognition には、保存された顔情報から一致する顔を検索するための追加の API オペレーションが用意されています。詳細については、「[ストレージ型 API オペレーション](how-it-works-storage-non-storage.md#how-it-works-storage-based)」を参照してください。
## AWS SDK または HTTP による Amazon Rekognition API オペレーションの呼び出し
AWS SDK を使用するか、直接 HTTP を使用して Amazon Rekognition API オペレーションを呼び出すことができます。正当な理由がない限り、常に AWS SDK を使用してください。このセクションの Java の例では、[AWS SDK](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-install.html) を使用しています。Java プロジェクトファイルは提供されていませんが、Java を使用する AWS アプリケーションは [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/AWSToolkitEclipse/latest/GettingStartedGuide/) で開発できます。
このセクションの .NET 例では [AWS SDK for .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/welcome.html) を使用します。[AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/welcome.html) では、.NET を使用して AWS アプリケーションを開発できます。便利なテンプレートと AWS Explorer を使用して、アプリケーションをデプロイし、サービスを管理できます。
このガイドの「[API Reference](https://docs.aws.amazon.com/rekognition/latest/APIReference/Welcome.html)」では、HTTP を使用した Amazon Rekognition オペレーションの呼び出しについて説明します。Java に関する参考情報については、「[AWS SDK for Java](https://docs.aws.amazon.com/sdk-for-java/latest/reference/index.html)」を参照してください。
使用できる Amazon Rekognition サービスエンドポイントについては、[[AWS のリージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html#rekognition_region)] を参照してください。
HTTP で Amazon Rekognition を呼び出す場合は、POST HTTP オペレーションを使用します。