映像和影片操作

Amazon Rekognition 提供兩個用於影像和視訊分析的主要 API 集：

• Amazon Rekognition 圖像：此 API 是專為分析圖像而設計的。

• Amazon Rekognition Video：此 API 著重於分析存儲和流式傳輸視頻。

這兩個 API 都可以檢測各種實體，例如面和對象。如需全面瞭解支援的比較和偵測類型，請參閱（詳見）一節分析類型。

Amazon Rekognition Image 操作

Amazon Rekognition 映像作業是同步的。輸入與回應為 JSON 格式。Amazon Rekognition Image 映像操作用於分析 .jpg 或 .png 映像格式的輸入映像檔。傳遞到 Amazon Rekognition Image 操作的映像可儲存於 Amazon S3 儲存貯體中。如果您沒有使用 AWS CLI，也可以將 Base64 編碼映像位元組直接傳遞至 Amazon Rekognition 操作。如需詳細資訊，請參閱使用影像。

Amazon Rekognition Video 操作

亞馬遜重新認知影片 API 有助於分析存放在 Amazon S3 儲存貯體或透過 Amazon Kinesis Video Streams 片。

對於儲存的視訊操作，請注意下列事項：

• 操作是異步的。

• 必須使用「開始」操作來啟動分析（例如，對StartFaceDetection於存儲的視頻中的臉部檢測）。

• 分析的完成狀態會發佈至 Amazon SNS 主題。

• 若要擷取分析結果，請使用對應的「取得」作業 (例如 GetFaceDetection)。

• 如需詳細資訊，請參閱使用儲存的視訊分析。

對於串流視訊分析：

• 功能包括 Rekognition 視訊集合中的臉部搜尋和標籤 (物件或概念) 偵測。

• 標籤的分析結果會以 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 開發套件或 HTTP 來呼叫 Amazon Rekognition API 操作

您可以使用 AWS 開發套件或直接使用 HTTP 來呼叫 Amazon Rekognition API 操作。除非有充分理由不使用 AWS 開發套件，否則應一律使用 AWS 開發套件。本節中的 Java 範例使用 AWS 開發套件。未提供 Java 專案檔案，但您可以使用 AWS Toolkit for Eclipse 來使用 Java 開發 AWS 應用程式。

本節中的 .NET 範例使用 AWS SDK for .NET。您可以使用 AWS Toolkit for Visual Studio 使用 .NET 開發 AWS 應用程式。它包含用於部署應用程式和管理服務的有用範本和 AWS Explorer。

本指南中的 API 参考 涵蓋使用 HTTP 呼叫 Amazon Rekognition 操作的方法。如需 Java 參考資訊，請參閱 AWS SDK for Java。

您可以使用的 Amazon Rekognition 服務端點記錄於 AWS 區域與端點。

以 HTTP 呼叫 Amazon Rekognition 時，請使用 POST HTTP 操作。