翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
コレクションへの顔の追加
IndexFaces オペレーションを使用すると、イメージ内の顔を検出し、コレクションに追加できます。Amazon Rekognition は、検出した顔ごとに顔の特徴を抽出し、その特徴情報をデータベースに保存します。さらに、検出した顔ごとのメタデータを、指定された顔コレクションに保存します。Amazon Rekognition は、実際のイメージのバイトを保存しません。
インデックス作成に適した顔の提供については、「顔比較用の入力イメージに関する推奨事項」を参照してください。
IndexFaces
オペレーションでは、顔ごとに以下の情報が保持されます。
-
顔の多次元特徴 –
IndexFaces
では顔分析を使用して、顔の特徴に関する多次元情報を抽出し、その情報を顔コレクションに保存します。この情報に直接アクセスすることはできません。ただし、Amazon Rekognition は顔コレクション内で一致する顔を検索するときに、この情報を使用します。 -
メタデータ – 各顔のメタデータには、境界ボックス、信頼度 (境界ボックスに顔が含まれている確率)、Amazon Rekognition によって割り当てられた ID (顔 ID とイメージ ID)、およびリクエストの外部イメージ ID (指定した場合) が含まれます。この情報は、
IndexFaces
API コールのレスポンスで返されます。例については、以下のレスポンスのface
要素を参照してください。このメタデータは、以下の API コールのレスポンスで返されます。
-
顔検索オペレーション – SearchFaces と SearchFacesByImage のレスポンスは、一致した顔ごとに一致の信頼度と、一致した顔のメタデータを返します。
IndexFaces
でインデックス付けされる顔の数は、入力コレクションに関連付けられている顔検出モデルのバージョンによって異なります。詳細については、「モデルのバージョニングについて」を参照してください。
インデックスが付けられた顔に関する情報が FaceRecord オブジェクトの配列で返されます。
インデックスが付けられた顔を、顔を検出したイメージに関連付けることができます。たとえば、イメージのクライアント側のインデックスとイメージ内の顔を保持できます。顔をイメージと関連付けるには、ExternalImageId
リクエストパラメータでイメージ ID を指定します。イメージ ID として、ファイル名を使用するか、別に作成した ID を使用できます。
API は、顔コレクションに保存する前述の情報に加えて、コレクションに保存されない顔の詳細も返します (以下のレスポンス例の faceDetail
要素を参照してください)。
注記
DetectFaces
から同じ情報が返されるため、同じイメージに対して DetectFaces
と IndexFaces
の両方を呼び出す必要はありません。
顔のフィルタリング
IndexFaces オペレーションにより、インデックスが付けられた顔をイメージからフィルタリングすることができます。IndexFaces
を使用すると、インデックスの顔の最大数を指定したり、高品質で検出された顔のみにインデックスを付けることを選択したりできます。
MaxFaces
入力パラメーターを使用して IndexFaces
によりインデックスが付けられる顔の最大数を指定することができます。この機能は、イメージ内の最も大きい顔にインデックスを付け、背景に立っている人の顔など、小さい顔にインデックスを付けない場合に役立ちます。
デフォルトでは、IndexFaces
は顔を除外するために使用する品質基準を選択します。QualityFilter
入力パラメータを使用して、品質基準を明示的に設定できます。 値は次のとおりです。
-
AUTO
— Amazon Rekognition は、顔のフィルタリングに使用する品質基準を選択します (デフォルト値)。 -
LOW
- 最低品質の顔を除くすべての顔がインデックス化されます。 -
MEDIUM
-
HIGH
- 最高品質の顔のみがインデックス化されます。 -
NONE
- 品質に基づいて顔が除外されません。
IndexFaces
は、次の理由により顔をフィルタリングします。
-
イメージサイズに比べて顔が小さすぎる。
-
顔が極端にぼやけている。
-
イメージが暗すぎる。
-
顔が極端なポーズをしている。
-
顔に、顔検索に適したディテールがない。
注記
品質フィルタリングを使用するには、バージョン 3 以上の顔モデルに関連付けられているコレクションが必要です。コレクションに関連付けられている顔モデルのバージョンを取得するには、DescribeCollection を呼び出します。
IndexFaces
によりインデックスが付けられていない顔に関する情報が UnindexedFace オブジェクトの配列で返されます。Reasons
配列には、顔にインデックスが付けられていない理由のリストが含まれています。たとえば、EXCEEDS_MAX_FACES
の値は、MaxFaces
により指定された顔の数が既に検出されているためにインデックスが付けられていない顔です。
詳細については、「コレクション内の顔の管理」を参照してください。
コレクションに顔を追加するには (SDK)
-
まだ実行していない場合:
-
AmazonRekognitionFullAccess
とAmazonS3ReadOnlyAccess
のアクセス権限を持つユーザーを作成または更新します。詳細については、「ステップ 1: AWS アカウントを設定してユーザーを作成する」を参照してください。 -
および AWS SDKs をインストール AWS CLI して設定します。詳細については、「ステップ 2: AWS CLI と AWS SDKsを設定する」を参照してください。
-
-
イメージ (1 つ以上の顔を含むもの) を Amazon S3 バケットにアップロードします。
手順については、「Amazon S3 へのオブジェクトのアップロード」のために、Amazon Simple ストレージサービスユーザーガイド を参照してください。
-
以下の例を使用して、
IndexFaces
オペレーションを呼び出します。
IndexFaces オペレーションのリクエスト
IndexFaces
への入力は、インデックス付けするイメージと顔を追加するコレクションです。
{ "CollectionId": "MyCollection", "Image": { "S3Object": { "Bucket": "bucket", "Name": "input.jpg" } }, "ExternalImageId": "input.jpg", "DetectionAttributes": [ "DEFAULT" ], "MaxFaces": 1, "QualityFilter": "AUTO" }
IndexFaces オペレーションのレスポンス
IndexFaces
は、イメージ内で検出された顔に関する情報を返します。たとえば、次の JSON レスポンスは、入力イメージ内で検出された顔のデフォルトの検出属性を返します。この例は、入力パラメータ MaxFaces
の値を超えたためにインデックスが付けられていない顔も示しています。- Reasons
配列には、EXCEEDS_MAX_FACES が含まれます。品質の理由で顔にインデックスが付けられない場合、Reasons
には LOW_SHARPNESS や LOW_BRIGHTNESS などの値が含まれます。詳細については、「UnindexedFace」を参照してください。
{ "FaceModelVersion": "3.0", "FaceRecords": [ { "Face": { "BoundingBox": { "Height": 0.3247932195663452, "Left": 0.5055555701255798, "Top": 0.2743072211742401, "Width": 0.21444444358348846 }, "Confidence": 99.99998474121094, "ExternalImageId": "input.jpg", "FaceId": "b86e2392-9da1-459b-af68-49118dc16f87", "ImageId": "09f43d92-02b6-5cea-8fbd-9f187db2050d" }, "FaceDetail": { "BoundingBox": { "Height": 0.3247932195663452, "Left": 0.5055555701255798, "Top": 0.2743072211742401, "Width": 0.21444444358348846 }, "Confidence": 99.99998474121094, "Landmarks": [ { "Type": "eyeLeft", "X": 0.5751981735229492, "Y": 0.4010535478591919 }, { "Type": "eyeRight", "X": 0.6511467099189758, "Y": 0.4017036259174347 }, { "Type": "nose", "X": 0.6314528584480286, "Y": 0.4710812568664551 }, { "Type": "mouthLeft", "X": 0.5879443287849426, "Y": 0.5171778798103333 }, { "Type": "mouthRight", "X": 0.6444502472877502, "Y": 0.5164633989334106 } ], "Pose": { "Pitch": -10.313642501831055, "Roll": -1.0316886901855469, "Yaw": 18.079818725585938 }, "Quality": { "Brightness": 71.2919921875, "Sharpness": 78.74752044677734 } } } ], "OrientationCorrection": "", "UnindexedFaces": [ { "FaceDetail": { "BoundingBox": { "Height": 0.1329464465379715, "Left": 0.5611110925674438, "Top": 0.6832437515258789, "Width": 0.08777777850627899 }, "Confidence": 92.37225341796875, "Landmarks": [ { "Type": "eyeLeft", "X": 0.5796897411346436, "Y": 0.7452847957611084 }, { "Type": "eyeRight", "X": 0.6078574657440186, "Y": 0.742687463760376 }, { "Type": "nose", "X": 0.597953200340271, "Y": 0.7620673179626465 }, { "Type": "mouthLeft", "X": 0.5884202122688293, "Y": 0.7920381426811218 }, { "Type": "mouthRight", "X": 0.60627681016922, "Y": 0.7919750809669495 } ], "Pose": { "Pitch": 15.658954620361328, "Roll": -4.583454608917236, "Yaw": 10.558992385864258 }, "Quality": { "Brightness": 42.54612350463867, "Sharpness": 86.93206024169922 } }, "Reasons": [ "EXCEEDS_MAX_FACES" ] } ] }
すべての顔の情報を取得するには、DetectionAttributes
リクエストパラメータに「ALL」を指定します。次のレスポンス例で、faceDetail
要素の追加情報はサーバーに保持されないことに注意してください。
-
25 の顔ランドマーク (前の例では 5 つのみ)
-
10 種類の顔属性 (眼鏡、あごひげ、歯並び、視線の方向など)
-
感情 (
emotion
要素を参照)
face
要素は、サーバーに保持されるメタデータを提供します。
FaceModelVersion
は、コレクションに関連付けられている顔モデルのバージョンです。詳細については、「モデルのバージョニングについて」を参照してください。
OrientationCorrection
は、イメージの向きの予測です。バージョン 3 よりも新しいバージョンの顔検出モデルを使用している場合、方向補正情報は返されません。詳細については、「イメージの向きおよび境界ボックス座標の取得」を参照してください。
次のレスポンス例は、["ALL"] を指定したときに返される JSON を示しています。
{ "FaceModelVersion": "3.0", "FaceRecords": [ { "Face": { "BoundingBox": { "Height": 0.06333333253860474, "Left": 0.17185185849666595, "Top": 0.7366666793823242, "Width": 0.11061728745698929 }, "Confidence": 99.99999237060547, "ExternalImageId": "input.jpg", "FaceId": "578e2e1b-d0b0-493c-aa39-ba476a421a34", "ImageId": "9ba38e68-35b6-5509-9d2e-fcffa75d1653" }, "FaceDetail": { "AgeRange": { "High": 25, "Low": 15 }, "Beard": { "Confidence": 99.98077392578125, "Value": false }, "BoundingBox": { "Height": 0.06333333253860474, "Left": 0.17185185849666595, "Top": 0.7366666793823242, "Width": 0.11061728745698929 }, "Confidence": 99.99999237060547, "Emotions": [ { "Confidence": 95.40877532958984, "Type": "HAPPY" }, { "Confidence": 6.6088080406188965, "Type": "CALM" }, { "Confidence": 0.7385611534118652, "Type": "SAD" } ], "EyeDirection": { "yaw": 16.299732, "pitch": -6.407457, "confidence": 99.968704 } "Eyeglasses": { "Confidence": 99.96795654296875, "Value": false }, "EyesOpen": { "Confidence": 64.0671157836914, "Value": true }, "Gender": { "Confidence": 100, "Value": "Female" }, "Landmarks": [ { "Type": "eyeLeft", "X": 0.21361233294010162, "Y": 0.757106363773346 }, { "Type": "eyeRight", "X": 0.2518567442893982, "Y": 0.7599404454231262 }, { "Type": "nose", "X": 0.2262365221977234, "Y": 0.7711842060089111 }, { "Type": "mouthLeft", "X": 0.2050037682056427, "Y": 0.7801263332366943 }, { "Type": "mouthRight", "X": 0.2430567592382431, "Y": 0.7836716771125793 }, { "Type": "leftPupil", "X": 0.2161938101053238, "Y": 0.756662905216217 }, { "Type": "rightPupil", "X": 0.2523181438446045, "Y": 0.7603650689125061 }, { "Type": "leftEyeBrowLeft", "X": 0.20066319406032562, "Y": 0.7501518130302429 }, { "Type": "leftEyeBrowUp", "X": 0.2130996286869049, "Y": 0.7480520606040955 }, { "Type": "leftEyeBrowRight", "X": 0.22584207355976105, "Y": 0.7504606246948242 }, { "Type": "rightEyeBrowLeft", "X": 0.24509544670581818, "Y": 0.7526801824569702 }, { "Type": "rightEyeBrowUp", "X": 0.2582615911960602, "Y": 0.7516844868659973 }, { "Type": "rightEyeBrowRight", "X": 0.26881539821624756, "Y": 0.7554477453231812 }, { "Type": "leftEyeLeft", "X": 0.20624476671218872, "Y": 0.7568746209144592 }, { "Type": "leftEyeRight", "X": 0.22105035185813904, "Y": 0.7582521438598633 }, { "Type": "leftEyeUp", "X": 0.21401576697826385, "Y": 0.7553104162216187 }, { "Type": "leftEyeDown", "X": 0.21317370235919952, "Y": 0.7584449648857117 }, { "Type": "rightEyeLeft", "X": 0.24393919110298157, "Y": 0.7600628137588501 }, { "Type": "rightEyeRight", "X": 0.2598416209220886, "Y": 0.7605880498886108 }, { "Type": "rightEyeUp", "X": 0.2519053518772125, "Y": 0.7582084536552429 }, { "Type": "rightEyeDown", "X": 0.25177454948425293, "Y": 0.7612871527671814 }, { "Type": "noseLeft", "X": 0.2185886949300766, "Y": 0.774715781211853 }, { "Type": "noseRight", "X": 0.23328955471515656, "Y": 0.7759330868721008 }, { "Type": "mouthUp", "X": 0.22446128726005554, "Y": 0.7805567383766174 }, { "Type": "mouthDown", "X": 0.22087252140045166, "Y": 0.7891407608985901 } ], "MouthOpen": { "Confidence": 95.87068939208984, "Value": false }, "Mustache": { "Confidence": 99.9828109741211, "Value": false }, "Pose": { "Pitch": -0.9409101605415344, "Roll": 7.233824253082275, "Yaw": -2.3602254390716553 }, "Quality": { "Brightness": 32.01998519897461, "Sharpness": 93.67259216308594 }, "Smile": { "Confidence": 86.7142105102539, "Value": true }, "Sunglasses": { "Confidence": 97.38925170898438, "Value": false } } } ], "OrientationCorrection": "ROTATE_0" "UnindexedFaces": [] }