Face Detection Operations - Detect From Session Image Id

リファレンス

サービス:: Azure AI Services

API バージョン:: v1.2-preview.1

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

大事な

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

- イメージは保存されません。抽出された顔機能のみがサーバーに格納されます。 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' 値を指定できます。さまざまな検出モデルを使用して比較するには、https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model を参照してください
  - 'detection_02': この検出モデルを選択した場合、顔の属性とランドマークは無効になります。
  - 'detection_03': この検出モデルを選択すると、顔の属性 (マスク、ぼかし、および headPose) とランドマークがサポートされます。
- 異なる 'recognitionModel' 値が提供されます。 "Verify"、"Identify"、"Find Similar" などのフォローアップ操作が必要な場合は、認識モデルを 'recognitionModel' パラメーターで指定してください。 'recognitionModel' の既定値は 'recognition_01' です。最新のモデルが必要な場合は、このパラメーターで必要なモデルを明示的に指定してください。指定すると、検出された faceId は、指定された認識モデルに関連付けられます。詳細については、https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-modelを参照してください。

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

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

POST {endpoint}/face/{apiVersion}/detect?_overload=detectFromSessionImageId&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' です。
faceIdTimeToLive	query		integer int32	キャッシュされる顔 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 の場合にのみ適用されます。

要求本文

名前	必須	型	説明
sessionImageId	True	string	セッションイメージの ID。

応答

名前	型	説明
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 From Session Image Id

要求のサンプル

HTTP

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

{
  "sessionImageId": "aa93ce80-9a9b-48bd-ae1a-1c7543841e92"
}

応答のサンプル

状態コード:: 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' です。
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

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

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

AccessoryType

アクセサリの種類。

名前	型	説明
glasses	string	眼鏡。
headwear	string	頭の摩耗。
mask	string	マスク。

BlurLevel

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

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

BlurProperties

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

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

DetectionModel

検出された faceId に関連付けられている 'detectionModel' です。サポートされている 'detectionModel' 値には、'detection_01'、'detection_02'、'detection_03' があります。既定値は 'detection_01' です。

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

ExposureLevel

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

名前	型	説明
goodExposure	string	良好な露出レベル。
overExposure	string	露出レベルが高い。
underExposure	string	露出レベルが低い。

ExposureProperties

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

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

FaceAttributes

検出された顔の顔属性。

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

FaceAttributeType

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

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

FaceDetectionResult

検出 API の応答。

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

FaceError

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

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

FaceErrorResponse

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

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

FaceLandmarks

顔コンポーネントの重要な位置を指す 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

顔が見つかる四角形。

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

FacialHair

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

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

GlassesType

顔の眼鏡の種類。

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

HairColor

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

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

HairColorType

髪の色の名前。

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

HairProperties

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

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

HeadPose

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

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

LandmarkCoordinate

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

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

MaskProperties

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

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

MaskType

マスクの種類。

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

NoiseLevel

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

名前	型	説明
high	string	高ノイズレベル。
low	string	低ノイズレベル。
medium	string	中程度のノイズレベル。

NoiseProperties

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

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

OcclusionProperties

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

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

QualityForRecognition

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

名前	型	説明
high	string	高品質。
low	string	低品質。
medium	string	中品質。

RecognitionModel

顔の認識モデル。

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

次の方法で共有

Face Detection Operations - Detect From Session Image Id

URI パラメーター

要求本文

応答

セキュリティ

Ocp-Apim-Subscription-Key

AADToken

スコープ

例

Detect From Session Image Id

要求のサンプル

応答のサンプル

定義

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

その他のリソース