인물 삭제

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

인물 DB에서 특정 인물을 삭제합니다. 인물을 삭제하면 해당 인물의 얼굴 특징 정보도 함께 삭제되어 유사 인물 조회와 인물 비교의 대상에서 제외됩니다.

주의

특정 인물을 삭제하면 인덱스에서 라벨링한 정보는 모두 초기화되어 익명 상태로 전환됩니다.
인물 삭제 작업은 취소할 수 없습니다.

요청

요청 형식을 설명합니다.

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

요청 헤더

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

요청 경로 파라미터

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

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

요청 예시

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

curl --location --request DELETE 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/persons/1001' \
--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.id`	Integer	-	인물 ID
`result.personId`	Integer	-	인물 ID `id`와 동일한 값
`result.name`	String	-	인물 이름 익명 인물은 null로 표시
`result.description`	String	-	인물 설명
`result.assetCount`	Integer	-	삭제 시점에 해당 인물이 등장하던 에셋 수
`result.sceneCount`	Integer	-	삭제 시점에 해당 인물이 등장하던 전체 장면 수
`result.tags`	Array	-	인물에 설정되어 있던 태그 목록: tags
`result.thumbnails`	Array	-	인물에 등록되어 있던 썸네일 목록: thumbnails

`tags`

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

필드	타입	필수 여부	설명
`id`	Integer	-	태그 ID
`name`	String	-	태그 이름

`thumbnails`

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

필드	타입	필수 여부	설명
`id`	Integer	-	썸네일 ID
`url`	String	-	썸네일 이미지 URL (Presigned URL)
`isPrimaryThumbnail`	Boolean	-	대표 썸네일 여부 `true` \| `false`
`thumbnailSource`	String	-	썸네일 등록 방식 `AUTO` \| `MANUAL` `AUTO`: 미디어 분석 과정에서 자동으로 추출된 썸네일 `MANUAL`: 사용자가 직접 업로드한 썸네일

응답 상태 코드

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

응답 예시

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

{
  "code": "0",
  "message": "success",
  "result": {
    "id": 1001,
    "personId": 1001,
    "name": "홍길동",
    "description": "한국의 대표적인 가상 인물입니다.",
    "assetCount": 12,
    "sceneCount": 47,
    "tags": [
      {
        "id": 201,
        "name": "가수"
      }
    ],
    "thumbnails": [
      {
        "id": 3001,
        "url": "https://kr.object.ncloudstorage.com/.../2747829644790202370.jpg?...",
        "isPrimaryThumbnail": true,
        "thumbnailSource": "MANUAL"
      }
    ]
  }
}