FindSimilarRequest interface

패키지:

@azure/cognitiveservices-face

유사한 작업을 찾기 위한 요청 본문입니다.

속성

faceId	쿼리 얼굴의 FaceId입니다. 사용자가 Face - Detect를 먼저 호출하여 유효한 faceId를 가져와야 합니다. 이 faceId는 유지되지 않으며 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다.
faceIds	후보 faceId의 배열입니다. 이러한 모든 항목은 Face - Detect에 의해 만들어지고 faceId는 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다. faceId의 수는 1000개로 제한됩니다. 매개 변수 faceListId, largeFaceListId 및 faceId는 동시에 제공되지 않아야 합니다.
faceListId	얼굴 목록 - 얼굴 목록 만들기에서 만든 기존 사용자 지정 고유 후보 얼굴 목록입니다. 얼굴 목록에는 지속되고 만료되지 않는 persistedFaceIds 집합이 포함되어 있습니다. 매개 변수 faceListId, largeFaceListId 및 faceId는 동시에 제공되지 않아야 합니다.
largeFaceListId	LargeFaceList - Create에서 만든 기존 사용자 지정 고유 후보 큰 얼굴 목록입니다. 큰 얼굴 목록에는 지속되고 만료되지 않는 persistedFaceIds 집합이 포함되어 있습니다. 매개 변수 faceListId, largeFaceListId 및 faceId는 동시에 제공되지 않아야 합니다.
maxNumOfCandidatesReturned	반환된 상위 유사한 얼굴의 수입니다. 유효한 범위는 [1, 1000]입니다. 기본값: 20.
mode	비슷한 얼굴 검색 모드입니다. "matchPerson" 또는 "matchFace"일 수 있습니다. 가능한 값은 'matchPerson', 'matchFace'입니다. 기본값: 'matchPerson'.

속성 세부 정보

faceId

쿼리 얼굴의 FaceId입니다. 사용자가 Face - Detect를 먼저 호출하여 유효한 faceId를 가져와야 합니다. 이 faceId는 유지되지 않으며 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다.

faceId: string

속성 값

string

faceIds

후보 faceId의 배열입니다. 이러한 모든 항목은 Face - Detect에 의해 만들어지고 faceId는 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다. faceId의 수는 1000개로 제한됩니다. 매개 변수 faceListId, largeFaceListId 및 faceId는 동시에 제공되지 않아야 합니다.

faceIds?: string[]

속성 값

string[]

faceListId

얼굴 목록 - 얼굴 목록 만들기에서 만든 기존 사용자 지정 고유 후보 얼굴 목록입니다. 얼굴 목록에는 지속되고 만료되지 않는 persistedFaceIds 집합이 포함되어 있습니다. 매개 변수 faceListId, largeFaceListId 및 faceId는 동시에 제공되지 않아야 합니다.

faceListId?: string

속성 값

string

largeFaceListId

LargeFaceList - Create에서 만든 기존 사용자 지정 고유 후보 큰 얼굴 목록입니다. 큰 얼굴 목록에는 지속되고 만료되지 않는 persistedFaceIds 집합이 포함되어 있습니다. 매개 변수 faceListId, largeFaceListId 및 faceId는 동시에 제공되지 않아야 합니다.

largeFaceListId?: string

속성 값

string

maxNumOfCandidatesReturned

반환된 상위 유사한 얼굴의 수입니다. 유효한 범위는 [1, 1000]입니다. 기본값: 20.

maxNumOfCandidatesReturned?: number

속성 값

number

mode

비슷한 얼굴 검색 모드입니다. "matchPerson" 또는 "matchFace"일 수 있습니다. 가능한 값은 'matchPerson', 'matchFace'입니다. 기본값: 'matchPerson'.

mode?: FindSimilarMatchMode

속성 값

FindSimilarMatchMode