Image Moderation - Find Faces Url Input

서비스:

Cognitive Services

API 버전:

1.0

찾은 얼굴 목록을 반환합니다.

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces

선택적 매개 변수:

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url&CacheImage={CacheImage}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	지원되는 Azure Cognitive Services 엔드포인트(프로토콜 및 호스트 이름(예: https://westus.api.cognitive.microsoft.com).
CacheImage	query		boolean	나중에 사용할 수 있도록 제출된 이미지를 유지할지 여부입니다. 생략하면 기본값은 false입니다.

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	콘텐츠 형식입니다.

요청 본문

Name	형식	Description
DataRepresentation	string
Value	string

응답

Name	형식	Description
200 OK	FoundFaces	찾은 얼굴 목록입니다.
Other Status Codes	APIError	오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

예제

Find Faces request

샘플 요청

HTTP

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url



{
  "DataRepresentation": "URL",
  "Value": "https://moderatorsampleimages.blob.core.windows.net/samples/img_300.jpg"
}

샘플 응답

상태 코드:

200

{
  "Faces": [
    {
      "Left": 80,
      "Right": 118,
      "Top": 44,
      "Bottom": 82
    }
  ],
  "Count": 1,
  "AdvancedInfo": [],
  "Result": true,
  "Status": {
    "Code": 3000,
    "Description": "OK",
    "Exception": ""
  },
  "TrackingId": "SEA_ad975eeae1f24f81bebb40be0c3ba4fd_ContentModerator.Preview_01158625-4fea-4dd5-8f21-5e2657ea2eee"
}

정의

Name	Description
APIError	API가 반환하는 오류 정보입니다.
Error	오류 본문입니다.
Face	찾은 얼굴에 대한 좌표입니다.
FoundFaces	찾은 얼굴을 포함하는 요청 개체입니다.
KeyValuePair	키/값 쌍 개체 속성입니다.
Status	상태 속성입니다.

APIError

API가 반환하는 오류 정보입니다.

Name	형식	Description
Error	Error	오류 본문입니다.

Error

오류 본문입니다.

Name	형식	Description
Code	string
Message	string

Face

찾은 얼굴에 대한 좌표입니다.

Name	형식	Description
Bottom	integer	아래쪽 좌표입니다.
Left	integer	왼쪽 좌표입니다.
Right	integer	오른쪽 좌표입니다.
Top	integer	위쪽 좌표입니다.

FoundFaces

찾은 얼굴을 포함하는 요청 개체입니다.

Name	형식	Description
AdvancedInfo	KeyValuePair[]	고급 정보입니다.
CacheId	string	캐시 ID입니다.
Count	integer	찾은 얼굴의 수입니다.
Faces	Face[]	얼굴 목록입니다.
Result	boolean	결과가 발견되면 True입니다.
Status	Status	평가 상태.
TrackingId	string	추적 ID입니다.

KeyValuePair

키/값 쌍 개체 속성입니다.

Name	형식	Description
Key	string	키 매개 변수입니다.
Value	string	값 매개 변수입니다.

Status

상태 속성입니다.

Name	형식	Description
Code	integer	상태 코드입니다.
Description	string	상태 설명입니다.
Exception	string	예외 상태.