イメージの仕様

Amazon Rekognition Image オペレーションでは、.jpg 形式または .png 形式の入力イメージを分析します。

イメージバイトを呼び出しの一部として Amazon Rekognition Image オペレーションに渡すか、既存の Amazon S3 オブジェクトを参照します。Amazon S3 バケットに保存されているイメージの分析例については、「Amazon S3 バケットに保存されたイメージの分析」を参照してください。Amazon Rekognition Image API オペレーションにイメージバイトを渡す例については、「ローカルファイルシステムからロードしたイメージの分析」を参照してください。

HTTP を使用して Amazon Rekognition Image オペレーションの一部として渡す場合のイメージバイトは、base64 でエンコードされた文字列であることが必要です。AWS SDK を使用して API オペレーションの呼び出しの一部としてイメージのバイトを渡す場合、イメージのバイトを Base64 でエンコードする必要があるかどうかは使用言語によって異なります。

以下の一般的な AWS SDK では、イメージを自動的に base64 でエンコードします。Amazon Rekognition Image API オペレーションを呼び出す前にイメージのバイトをエンコードする必要はありません。

• Java

• JavaScript

• Python

• PHP

別の AWS SDK を使用しているときに Rekognition API オペレーションの呼び出しに伴ってイメージ形式エラーが発生した場合は、イメージのバイトを base64 でエンコードしてから Rekognition API オペレーションに渡してみてください。

AWS CLI を使用して Amazon Rekognition Image オペレーションを呼び出す場合、呼び出しの一部としてイメージのバイトを渡すことはサポートされていません。最初に Amazon S3 バケットにイメージをアップロードし、次にアップロードしたイメージを参照するオペレーションを呼び出します。

注記

イメージのバイトの代わりに S3Object に保存されたイメージを渡す場合は、イメージを base64 でエンコードする必要はありません。

Amazon Rekognition オペレーションのレイテンシーをできるだけ低くする方法の詳細については、「Amazon Rekognition イメージオペレーションのレイテンシ」を参照してください。

イメージの向きの修正

いくつかの Rekognition　API オペレーションでは、分析されたイメージの向きが返されます。イメージの向きを知ることは、表示用にイメージの向きを変えるために重要です。顔を分析する Rekognition API オペレーションでは、イメージ内の顔の位置の境界ボックスも返されます。境界ボックスを使用して、顔またはイメージの周囲にボックスを表示できます。返される境界ボックスの座標は、イメージの向きによって影響を受けます。顔の周囲に正しくボックスを表示するには、境界ボックスの座標の変換が必要になる場合があります。詳細については、「イメージの向きおよび境界ボックス座標の取得」を参照してください。

イメージのサイズ変更

Amazon Rekognition は、分析中に特定のモデルまたはアルゴリズムに最も適した定義済みの範囲のセットを使用して、内部的に画像のサイズを変更します。Amazon Rekognition は、入力イメージの解像度に応じて、異なる数のオブジェクトを検出したり、異なる結果を提供したりすることがあります。たとえば、2 つのイメージがあるとします。最初の画像の解像度は 1024 x 768 ピクセルです。2 番目の画像 (最初のイメージのサイズを変更したバージョン) の解像度は 640 x 480 ピクセルです。画像を DetectLabels に送信した場合、DetectLabels への 2 つの呼び出しの応答は若干異なる可能性があります。