유사 인물 조회

VPC 환경에서 이용 가능합니다.

지정한 인물과 얼굴이 유사한 인물을 유사도 순으로 조회합니다. 조회 결과는 인물 통합의 후보로 활용할 수 있습니다.

참고

썸네일이 등록되지 않아 얼굴 특징 정보가 없는 인물은 유사 인물을 조회할 수 없습니다. 등록된 이미지 기준이 아니라 새로운 이미지를 기준으로 유사 인물을 확인하려면 인물 비교를 사용해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/api/v1/workspaces/{workspace_name}/persons/{person_id}/similar

요청 헤더

Media Intelligence API에서 공통으로 사용하는 헤더에 대한 정보는 Media Intelligence 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`workspace_name`	String	Required	워크스페이스 이름
`person_id`	String	Required	기준 인물 ID 인물 목록 조회 참조

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`personCount`	Integer	Optional	조회할 유사 인물 수 1~10 (기본값: 3)
`scoreThreshold`	Integer	Optional	유사 인물로 판단할 기준 유사도 80~100 (기본값: 80)

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/persons/1001/similar?personCount=3&scoreThreshold=80' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`code`	String	-	API 처리 결과 코드
`message`	String	-	API 처리 결과 메시지
`result`	Object	-	유사 인물 조회 결과
`result.personId`	Integer	-	기준 인물 ID
`result.similarPersons`	Array	-	유사 인물 목록: similarPersons 유사도 내림차순 조건에 해당하는 인물이 없는 경우 빈 배열

`similarPersons`

similarPersons에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`personId`	Integer	-	유사 인물의 인물 ID
`name`	String	-	유사 인물의 이름 익명 인물은 null로 표시
`score`	Number	-	기준 인물과의 유사도 0~100
`assetCount`	Integer	-	유사 인물이 등장하는 에셋 수

응답 상태 코드

Media Intelligence API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Media Intelligence 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
  "code": "0",
  "message": "success",
  "result": {
    "personId": 1001,
    "similarPersons": [
      {
        "personId": 1002,
        "name": null,
        "score": 93.42,
        "assetCount": 3
      },
      {
        "personId": 1003,
        "name": "홍길순",
        "score": 82.13,
        "assetCount": 1
      }
    ]
  }
}