Face Detection Operations - Detect

サービス:: Azure AI Services

API バージョン:: v1.2

画像内の人間の顔を検出し、顔の四角形を返し、必要に応じて faceId、ランドマーク、属性を使用します。

大事な

Microsoft は、感情状態と ID 属性を推測するために使用できる顔認識機能を廃止または制限しました。この機能は、誤用された場合、人々がステレオタイピング、差別、または不公平なサービス拒否を受ける可能性があります。廃止された機能は感情と性別です。限られた機能は年齢、笑顔、顔の毛、髪とメイクです。 Azure Face API 電子メール、制限された機能のいずれかを使用することでメリットを得られる責任あるユースケースがある場合に使用できます。この決定の詳細については、を参照してください。

- イメージは保存されません。抽出された顔機能のみがサーバーに格納されます。 faceId は顔機能の識別子であり、"Identify"、"Verify"、および "Find Similar" で使用されます。格納された顔機能は有効期限が切れ、元の検出呼び出しの後に faceIdTimeToLive で指定された時刻に削除されます。
- 省略可能なパラメーターには、faceId、ランドマーク、属性が含まれます。属性には、headPose、眼鏡、オクルージョン、アクセサリ、ぼかし、露出、ノイズ、マスク、qualityForRecognition などがあります。特定の属性に対して返される結果の一部は、精度が高くない場合があります。
- JPEG、PNG、GIF (最初のフレーム)、BMP 形式がサポートされています。許可されるイメージファイルのサイズは 1 KB から 6 MB です。
- 検出可能な顔の最小サイズは、1920 x 1080 ピクセル以下の画像では 36 x 36 ピクセルです。サイズが 1920 x 1080 ピクセルを超える画像では、顔の最小サイズが比例して大きくなる必要があります。
- 画像に対して最大 100 個の顔を返すことができます。顔は、大きいから小さい顔の四角形のサイズでランク付けされます。
- "Identify"、"Verify"、"Find Similar" ('returnFaceId' is true) のクエリを実行するときに最適な結果を得るには、正面、クリア、最小サイズが 200 x 200 ピクセル (目の間に 100 ピクセル) の顔を使用してください。
- 異なる 'detectionModel' 値を指定できます。ランドマークとサポートされる属性の可用性は、指定された検出モデルによって異なります。さまざまな検出モデルを使用して比較するには、のを参照してください。
- 異なる 'recognitionModel' 値が提供されます。 "Verify"、"Identify"、"Find Similar" などのフォローアップ操作が必要な場合は、認識モデルを 'recognitionModel' パラメーターで指定してください。 'recognitionModel' の既定値は 'recognition_01' です。最新のモデルが必要な場合は、このパラメーターで必要なモデルを明示的に指定してください。指定すると、検出された faceId は、指定された認識モデルに関連付けられます。詳細については、を参照してください。

POST {endpoint}/face/{apiVersion}/detect

省略可能なパラメーターを含む:

POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

URI パラメーター

名前	/	必須	型	説明
apiVersion	path	True	string	API バージョン
endpoint	path	True	string (uri)	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名。例: https://{resource-name}.cognitiveservices.azure.com)。
detectionModel	query		DetectionModel	検出された faceId に関連付けられている 'detectionModel' です。サポートされている 'detectionModel' 値には、'detection_01'、'detection_02'、'detection_03' があります。既定値は 'detection_01' です。小さい顔 (64 x 64 ピクセル) と回転した面の向きで精度が向上するため、"detection_03" をお勧めします。
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	キャッシュされる顔 ID の秒数。サポートされる範囲は、60 秒から 8,6400 秒までです。既定値は 86400 (24 時間) です。
recognitionModel	query		RecognitionModel	検出された faceIds に関連付けられている 'recognitionModel' です。サポートされている 'recognitionModel' の値には、'recognition_01'、'recognition_02'、'recognition_03'、または 'recognition_04' があります。既定値は 'recognition_01' です。 'recognition_04' は、マスクを装着している顔の精度が 'recognition_03' と比較して向上し、"recognition_01" や "recognition_02" と比較して全体的な精度が向上するため、推奨されます。
returnFaceAttributes	query		FaceAttributeType[]	'returnFaceAttributes=headPose,glasses' のようなコンマ区切り文字列内の 1 つ以上の指定された顔属性を分析して返します。顔属性分析には、追加の計算コストと時間コストがあります。
returnFaceId	query		boolean	検出された顔の faceId を返すかどうか。既定値は true です。
returnFaceLandmarks	query		boolean	検出された顔の顔ランドマークを返すかどうか。既定値は false です。
returnRecognitionModel	query		boolean	'recognitionModel' を返すかどうか。既定値は false です。これは、returnFaceId = true の場合にのみ適用されます。

要求本文

Media Types: "application/octet-stream"

名前	型	説明
imageContent	string (binary)	入力イメージのバイナリ。

応答

名前	型	説明
200 OK	FaceDetectionResult[]	呼び出しが成功すると、顔の四角形のサイズで降順にランク付けされた顔エントリの配列が返されます。空の応答は、顔が検出されていないことを示します。
Other Status Codes	FaceErrorResponse	予期しないエラー応答。ヘッダー x-ms-error-code: string

名前

型

説明

200 OK

FaceDetectionResult[]

呼び出しが成功すると、顔の四角形のサイズで降順にランク付けされた顔エントリの配列が返されます。空の応答は、顔が検出されていないことを示します。

Other Status Codes

FaceErrorResponse

予期しないエラー応答。

ヘッダー

x-ms-error-code: string

セキュリティ

Ocp-Apim-Subscription-Key

Azure AI Face サブスクリプションの秘密鍵。

型: apiKey
/: header

AADToken

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://api.example.com/oauth2/authorize
Token URL (トークン URL): https://api.example.com/oauth2/token

スコープ

名前	説明
https://cognitiveservices.azure.com/.default

例

Detect with Image

要求のサンプル

HTTP

POST {endpoint}/face/v1.2/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

応答のサンプル

状態コード:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_03",
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 412.7,
        "y": 78.4
      },
      "pupilRight": {
        "x": 446.8,
        "y": 74.2
      },
      "noseTip": {
        "x": 437.7,
        "y": 92.4
      },
      "mouthLeft": {
        "x": 417.8,
        "y": 114.4
      },
      "mouthRight": {
        "x": 451.3,
        "y": 109.3
      },
      "eyebrowLeftOuter": {
        "x": 397.9,
        "y": 78.5
      },
      "eyebrowLeftInner": {
        "x": 425.4,
        "y": 70.5
      },
      "eyeLeftOuter": {
        "x": 406.7,
        "y": 80.6
      },
      "eyeLeftTop": {
        "x": 412.2,
        "y": 76.2
      },
      "eyeLeftBottom": {
        "x": 413,
        "y": 80.1
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7
      },
      "eyeRightBottom": {
        "x": 447,
        "y": 75.3
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4
      },
      "noseRootLeft": {
        "x": 428,
        "y": 77.1
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87
      },
      "noseLeftAlarOutTip": {
        "x": 424.3,
        "y": 96.4
      },
      "noseRightAlarOutTip": {
        "x": 446.6,
        "y": 92.5
      },
      "upperLipTop": {
        "x": 437.6,
        "y": 105.9
      },
      "upperLipBottom": {
        "x": 437.6,
        "y": 108.2
      },
      "underLipTop": {
        "x": 436.8,
        "y": 111.4
      },
      "underLipBottom": {
        "x": 437.3,
        "y": 114.5
      }
    },
    "faceAttributes": {
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "headwear",
          "confidence": 0.99
        },
        {
          "type": "glasses",
          "confidence": 1
        },
        {
          "type": "mask",
          "confidence": 0.87
        }
      ],
      "blur": {
        "blurLevel": "medium",
        "value": 0.51
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.55
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.12
      },
      "qualityForRecognition": "high"
    }
  }
]

定義

名前	説明
AccessoryItem	アクセサリアイテムと対応する信頼度レベル。
AccessoryType	アクセサリの種類。
BlurLevel	ぼかしのレベルを示します。
BlurProperties	イメージ内のぼかしの存在を記述するプロパティ。
DetectionModel	検出された faceId に関連付けられている 'detectionModel' です。サポートされている 'detectionModel' 値には、'detection_01'、'detection_02'、'detection_03' があります。既定値は 'detection_01' です。小さい顔 (64 x 64 ピクセル) と回転した面の向きで精度が向上するため、"detection_03" をお勧めします。
ExposureLevel	露出のレベルを示します。
ExposureProperties	画像の露出レベルを記述するプロパティ。
FaceAttributes	検出された顔の顔属性。
FaceAttributeType	'returnFaceAttributes=headPose,glasses' のようなコンマ区切り文字列内の 1 つ以上の指定された顔属性を分析して返します。顔属性分析には、追加の計算コストと時間コストがあります。
FaceDetectionResult	検出 API の応答。
FaceError	エラーオブジェクト。 Face サービスによって返されるエラーコードとメッセージの詳細については、次のリンクを参照してください: https://aka.ms/face-error-codes-and-messages。
FaceErrorResponse	エラーの詳細を含む応答。
FaceLandmarks	顔コンポーネントの重要な位置を指す 27 ポイントの顔ランドマークのコレクション。
FaceRectangle	顔が見つかる四角形。
FacialHair	顔の毛の属性を記述するプロパティ。
GlassesType	顔の眼鏡の種類。
HairColor	それぞれの存在する候補の色と信頼度レベルの配列。
HairColorType	髪の色の名前。
HairProperties	ヘア属性を記述するプロパティ。
HeadPose	顔方向の 3-D ロール/ヨー/ピッチ角度。
LandmarkCoordinate	画像内のランドマーク座標。
MaskProperties	特定の顔にマスクが存在することを示すプロパティ。
MaskType	マスクの種類。
NoiseLevel	ノイズのレベルを示します。
NoiseProperties	画像のノイズレベルを記述するプロパティ。
OcclusionProperties	特定の顔のオクルージョンを記述するプロパティ。
QualityForRecognition	認識用の画像の品質を示します。
RecognitionModel	顔の認識モデル。

AccessoryItem

Object

アクセサリアイテムと対応する信頼度レベル。

名前	型	説明
confidence	number (float) minimum: 0 maximum: 1	アクセサリの種類の信頼度レベル。 [0,1] の範囲。
type	AccessoryType	アクセサリの種類。

AccessoryType

列挙

アクセサリの種類。

値	説明
headwear	頭の摩耗。
glasses	眼鏡。
mask	マスク。

BlurLevel

列挙

ぼかしのレベルを示します。

値	説明
low	低ぼかしレベル。
medium	中程度のぼかしレベル。
high	ぼかしレベルが高い。

BlurProperties

Object

イメージ内のぼかしの存在を記述するプロパティ。

名前	型	説明
blurLevel	BlurLevel	ぼかしのレベルを示す列挙値。
value	number (float) minimum: 0 maximum: 1	0 ~ 1 の範囲のぼかしのレベルを示す数値。

DetectionModel

列挙

検出された faceId に関連付けられている 'detectionModel' です。サポートされている 'detectionModel' 値には、'detection_01'、'detection_02'、'detection_03' があります。既定値は 'detection_01' です。小さい顔 (64 x 64 ピクセル) と回転した面の向きで精度が向上するため、"detection_03" をお勧めします。

値	説明
detection_01	既定の検出モデル。正面近くの顔検出にお勧めします。非常に大きな角度 (頭部姿勢) の顔、隠れた顔、または間違った画像の向きのシナリオでは、そのような場合は顔が検出されない可能性があります。
detection_02	2019 年 5 月にリリースされた検出モデルで、特に小さい顔、側面、ぼやけた顔の精度が向上しました。
detection_03	2021 年 2 月にリリースされた検出モデルで、特に小さい顔の精度が向上しました。

ExposureLevel

列挙

露出のレベルを示します。

値	説明
underExposure	露出レベルが低い。
goodExposure	良好な露出レベル。
overExposure	露出レベルが高い。

ExposureProperties

Object

画像の露出レベルを記述するプロパティ。

名前	型	説明
exposureLevel	ExposureLevel	露出のレベルを示す列挙値。
value	number (float) minimum: 0 maximum: 1	0 ~ 1 の範囲の露出レベルを示す数値。 [0, 0.25) が露出している。 [0.25, 0.75) は良好な露出です。 [0.75, 1]は露出超過です。

FaceAttributes

Object

検出された顔の顔属性。

名前	型	説明
accessories	AccessoryItem[]	特定の顔のアクセサリを記述するプロパティ。
age	number (float)	年単位の年齢。
blur	BlurProperties	イメージ内のぼかしの存在を記述するプロパティ。
exposure	ExposureProperties	画像の露出レベルを記述するプロパティ。
facialHair	FacialHair	顔の毛の属性を記述するプロパティ。
glasses	GlassesType	眼鏡の種類は、いずれかの顔の場合です。
hair	HairProperties	ヘア属性を記述するプロパティ。
headPose	HeadPose	顔方向の 3-D ロール/ヨー/ピッチ角度。
mask	MaskProperties	特定の顔にマスクが存在することを示すプロパティ。
noise	NoiseProperties	画像のノイズレベルを記述するプロパティ。
occlusion	OcclusionProperties	特定の顔のオクルージョンを記述するプロパティ。
qualityForRecognition	QualityForRecognition	検出に使用されている画像が顔認識を試みるために十分な品質であるかどうかに関する全体的な画質を記述するプロパティ。
smile	number (float) minimum: 0 maximum: 1	笑顔の強さ、[0,1]の間の数値。

FaceAttributeType

列挙

'returnFaceAttributes=headPose,glasses' のようなコンマ区切り文字列内の 1 つ以上の指定された顔属性を分析して返します。顔属性分析には、追加の計算コストと時間コストがあります。

値	説明
headPose	顔方向の 3-D ロール/ヨー/ピッチ角度。
glasses	眼鏡の種類。値には、"NoGlasses"、"ReadingGlasses"、"サングラス"、"SwimmingGoggles" などがあります。
occlusion	額、目、口など、顔の各領域が隠れているかどうか。
accessories	「帽子」、「眼鏡」、「マスク」など、顔の周りのアクセサリー。空の配列は、アクセサリが検出されていないことを意味します。これは顔が検出された後であることに注意してください。マスクが大きいと、顔が検出されない可能性があります。
blur	顔がぼやけているかどうか。 Level は、'Low'、'Medium'、または 'High' を返します。値は [0,1] の間の数値を返し、ぼかしが大きいほど大きくなります。
exposure	顔の露出レベル。 Level は'GoodExposure'、'OverExposure'、または 'UnderExposure' を返します。
noise	顔ピクセルのノイズレベル。 Level は、'Low'、'Medium'、および 'High' を返します。値は [0,1] の間の数値を返します。値が大きいほど、
mask	各顔がマスクを着用しているかどうか。マスク型は、'noMask'、'faceMask'、'otherMaskOrOcclusion'、または '不確実' を返します。値は、鼻と口が覆われているかどうかを示すブール値 'noseAndMouthCovered' を返します。
qualityForRecognition	検出に使用されている画像が顔認識を試みるために十分な品質であるかどうかに関する全体的な画質。値は、低、中、または高の非公式の評価です。識別シナリオでは、"中" 以上の人物登録と品質に対して "高品質" の画像のみが推奨されます。この属性は、認識モデルrecognition_03またはrecognition_04を使用する場合にのみ使用できます。
age	年単位の年齢。
smile	笑顔の強さ、[0,1]の間の数値。
facialHair	顔の毛の属性を記述するプロパティ。
hair	ヘア属性を記述するプロパティ。

FaceDetectionResult

Object

検出 API の応答。

名前	型	説明
faceAttributes	FaceAttributes	検出された顔の顔属性。
faceId	string (uuid)	検出 API によって作成された検出された顔の一意の faceId。検出呼び出しの 24 時間後に有効期限が切れます。これを返すには、'returnFaceId' パラメーターが true である必要があります。
faceLandmarks	FaceLandmarks	顔コンポーネントの重要な位置を指す 27 ポイントの顔ランドマークの配列。これを返すには、'returnFaceLandmarks' パラメーターが true である必要があります。
faceRectangle	FaceRectangle	画像上の顔の位置の四角形領域。
recognitionModel	RecognitionModel	この faceId に関連付けられている 'recognitionModel' です。これは、'returnRecognitionModel' が明示的に true に設定されている場合にのみ返されます。

FaceError

Object

エラーオブジェクト。 Face サービスによって返されるエラーコードとメッセージの詳細については、次のリンクを参照してください: https://aka.ms/face-error-codes-and-messages。

名前	型	説明
code	string	サーバー定義の一連のエラーコードの 1 つ。
message	string	エラーの人間が判読できる表現。

FaceErrorResponse

Object

エラーの詳細を含む応答。

名前	型	説明
error	FaceError	エラーオブジェクト。

FaceLandmarks

Object

顔コンポーネントの重要な位置を指す 27 ポイントの顔ランドマークのコレクション。

名前	型	説明
eyeLeftBottom	LandmarkCoordinate	左目の下の座標。
eyeLeftInner	LandmarkCoordinate	左目の内側の座標。
eyeLeftOuter	LandmarkCoordinate	左目の外側の座標。
eyeLeftTop	LandmarkCoordinate	左目の上の座標。
eyeRightBottom	LandmarkCoordinate	右目の下の座標。
eyeRightInner	LandmarkCoordinate	右目の内側の座標。
eyeRightOuter	LandmarkCoordinate	右目の外側の座標。
eyeRightTop	LandmarkCoordinate	右目の上の座標。
eyebrowLeftInner	LandmarkCoordinate	左の眉の内側の座標。
eyebrowLeftOuter	LandmarkCoordinate	左つゆの外側の座標。
eyebrowRightInner	LandmarkCoordinate	右の眉の内側の座標。
eyebrowRightOuter	LandmarkCoordinate	右のつゆの外側の座標。
mouthLeft	LandmarkCoordinate	マウスの左の座標。
mouthRight	LandmarkCoordinate	右の口の座標。
noseLeftAlarOutTip	LandmarkCoordinate	鼻の座標は、明らかな先端を残しました。
noseLeftAlarTop	LandmarkCoordinate	鼻左アラートップの座標。
noseRightAlarOutTip	LandmarkCoordinate	鼻の座標は、先端を右にアラーアウトします。
noseRightAlarTop	LandmarkCoordinate	鼻右アラートップの座標。
noseRootLeft	LandmarkCoordinate	左の鼻根の座標。
noseRootRight	LandmarkCoordinate	鼻根右の座標。
noseTip	LandmarkCoordinate	鼻先端の座標。
pupilLeft	LandmarkCoordinate	左目の瞳孔の座標。
pupilRight	LandmarkCoordinate	右目の瞳孔の座標。
underLipBottom	LandmarkCoordinate	下唇の下の座標。
underLipTop	LandmarkCoordinate	下リップトップの座標。
upperLipBottom	LandmarkCoordinate	上唇の下部の座標。
upperLipTop	LandmarkCoordinate	上リップトップの座標。

FaceRectangle

Object

顔が見つかる四角形。

名前	型	説明
height	integer (int32)	四角形の高さ (ピクセル単位)。
left	integer (int32)	画像から四角形の左端までの距離 (ピクセル単位)。
top	integer (int32)	画像が四角形の上端までの場合の上端からの距離 (ピクセル単位)。
width	integer (int32)	四角形の幅 (ピクセル単位)。

FacialHair

Object

顔の毛の属性を記述するプロパティ。

名前	型	説明
beard	number (float) minimum: 0 maximum: 1	プロパティに関連付けられている信頼度のレベルを示す 0 から 1 までの範囲の数値。
moustache	number (float) minimum: 0 maximum: 1	プロパティに関連付けられている信頼度のレベルを示す 0 から 1 までの範囲の数値。
sideburns	number (float) minimum: 0 maximum: 1	プロパティに関連付けられている信頼度のレベルを示す 0 から 1 までの範囲の数値。

GlassesType

列挙

顔の眼鏡の種類。

値	説明
noGlasses	顔に眼鏡をかけない。
readingGlasses	顔に通常の眼鏡。
sunglasses	顔にサングラス。
swimmingGoggles	顔に水泳の眼鏡。

HairColor

Object

それぞれの存在する候補の色と信頼度レベルの配列。

名前	型	説明
color	HairColorType	髪の色の名前。
confidence	number (float) minimum: 0 maximum: 1	色の信頼度レベル。 [0,1] の範囲。

HairColorType

列挙

髪の色の名前。

値	説明
unknown	不明。
white	白い。
gray	灰色。
blond	金髪の。
brown	褐色。
red	赤い。
black	黒い。
other	他。

HairProperties

Object

ヘア属性を記述するプロパティ。

名前	型	説明
bald	number (float) minimum: 0 maximum: 1	その人がはげかどうかを示す信頼度レベルを表す数値。
hairColor	HairColor[]	それぞれの存在する候補の色と信頼度レベルの配列。
invisible	boolean	イメージにヘアが表示されるかどうかを示すブール値。

HeadPose

Object

顔方向の 3-D ロール/ヨー/ピッチ角度。

名前	型	説明
pitch	number (float)	角度の値。
roll	number (float)	角度の値。
yaw	number (float)	角度の値。

LandmarkCoordinate

Object

画像内のランドマーク座標。

名前	型	説明
x	number (float)	水平方向のコンポーネント (ピクセル単位)。
y	number (float)	垂直方向のコンポーネント (ピクセル単位)。

MaskProperties

Object

特定の顔にマスクが存在することを示すプロパティ。

名前	型	説明
noseAndMouthCovered	boolean	鼻と口が覆われているかどうかを示すブール値。
type	MaskType	マスクの種類。

MaskType

列挙

マスクの種類。

値	説明
faceMask	フェイスマスク。
noMask	マスクなし。
otherMaskOrOcclusion	その他の種類のマスクまたはオクルージョン。
uncertain	危うい。

NoiseLevel

列挙

ノイズのレベルを示します。

値	説明
low	低ノイズレベル。
medium	中程度のノイズレベル。
high	高ノイズレベル。

NoiseProperties

Object

画像のノイズレベルを記述するプロパティ。

名前	型	説明
noiseLevel	NoiseLevel	ノイズのレベルを示す列挙値。
value	number (float) minimum: 0 maximum: 1	0 ~ 1 の範囲のノイズレベルを示す数値。 [0, 0.25) が露出している。 [0.25, 0.75) は良好な露出です。 [0.75, 1]は露出超過です。 [0, 0.3) は低ノイズレベルです。 [0.3, 0.7) は中程度のノイズレベルです。 [0.7, 1]はノイズレベルが高い。

OcclusionProperties

Object

特定の顔のオクルージョンを記述するプロパティ。

名前	型	説明
eyeOccluded	boolean	目が隠れているかどうかを示すブール値。
foreheadOccluded	boolean	額が隠れているかどうかを示すブール値。
mouthOccluded	boolean	口が隠れているかどうかを示すブール値。

QualityForRecognition

列挙

認識用の画像の品質を示します。

値	説明
low	低品質。
medium	中品質。
high	高品質。

RecognitionModel

列挙

顔の認識モデル。

値	説明
recognition_01	"Detect" の既定の認識モデル。 2019 年 3 月より前に作成されたすべての faceId は、この認識モデルと結合されます。
recognition_02	2019 年 3 月にリリースされた認識モデル。
recognition_03	2020 年 5 月にリリースされた認識モデル。
recognition_04	2021 年 2 月にリリースされた認識モデル。認識精度を向上させるために、この認識モデルを使用することをお勧めします。

次の方法で共有

Face Detection Operations - Detect

URI パラメーター

要求本文

応答

セキュリティ

Ocp-Apim-Subscription-Key

AADToken

スコープ

例

Detect with Image

要求のサンプル

応答のサンプル

定義

AccessoryItem

AccessoryType

BlurLevel

BlurProperties

DetectionModel

ExposureLevel

ExposureProperties

FaceAttributes

FaceAttributeType

FaceDetectionResult

FaceError

FaceErrorResponse

FaceLandmarks

FaceRectangle

FacialHair

GlassesType

HairColor

HairColorType

HairProperties

HeadPose

LandmarkCoordinate

MaskProperties

MaskType

NoiseLevel

NoiseProperties

OcclusionProperties

QualityForRecognition

RecognitionModel