Image Analysis 3.2 での顔検出
Image Analysis 3.2 は、画像内の人間の顔を検出し、検出された顔ごとに四角形の座標を生成できます。
Note
この機能は、専用の Azure AI Face サービスでも利用できます。 その代替手段は、顔識別や頭部姿勢検出など、より詳細な顔分析に使用します。
注意事項
感情の状態やアイデンティティの属性の推測に使用できる顔認識機能は廃止されました。この機能は使い方を誤ると、ステレオタイプ化、差別、サービスの不当な拒否に人々をさらす可能性があります。 たとえば、感情、性別、年齢、笑顔、顔ひげ、髪、メイクを予測する機能が該当します。 この決定について詳しくは、こちらをご覧ください。
顔検出の例
次の例では、人の顔を 1 つ含む画像に対して Analyze API によって返される JSON 応答を示します。
{
"faces": [
{
"age": 23,
"gender": "Female",
"faceRectangle": {
"top": 45,
"left": 194,
"width": 44,
"height": 44
}
}
],
"requestId": "8439ba87-de65-441b-a0f1-c85913157ecd",
"metadata": {
"height": 200,
"width": 300,
"format": "Png"
}
}
次の例では、複数の顔を含む画像に対して返される JSON 応答を示します。
{
"faces": [
{
"age": 11,
"gender": "Male",
"faceRectangle": {
"top": 62,
"left": 22,
"width": 45,
"height": 45
}
},
{
"age": 11,
"gender": "Female",
"faceRectangle": {
"top": 127,
"left": 240,
"width": 42,
"height": 42
}
},
{
"age": 37,
"gender": "Female",
"faceRectangle": {
"top": 55,
"left": 200,
"width": 41,
"height": 41
}
},
{
"age": 41,
"gender": "Male",
"faceRectangle": {
"top": 45,
"left": 103,
"width": 39,
"height": 39
}
}
],
"requestId": "3a383cbe-1a05-4104-9ce7-1b5cf352b239",
"metadata": {
"height": 230,
"width": 300,
"format": "Png"
}
}
API の使用
顔検出機能は Analyze Image 3.2 API に含まれています。 ネイティブ SDK または REST を呼び出すことでこの API を呼び出すことができます。 Faces を visualFeatures クエリ パラメーターに追加します。 その後、完全な JSON 応答が得られたら、"faces" セクションのコンテンツを対象に文字列を解析します。