인물 썸네일 업로드 상태 조회

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

Presigned URL을 통해 인물 썸네일 이미지를 업로드한 후, 해당 이미지의 업로드 완료 상태를 확인합니다.

참고

호출 제한: 분당 1,000건

요청

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

메서드	URI
POST	/api/v1/workspaces/{workspace_name}/person-thumbnail/uploads/complete

요청 헤더

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

요청 경로 파라미터

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

필드	타입	필수 여부	설명
`workspace_name`	String	Required	워크스페이스 이름

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`thumbnailKey`	String	Required	업로드 완료 여부를 확인할 이미지 파일의 키 값 사전에 Presigned URL 발급 API 호출을 통해 발급받은 `thumbnailKey` 사용

요청 예시

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

curl --location --request POST 'https://maiu.apigw.ntruss.com/api/v1/workspaces/my-workspace/person-thumbnail/complete' \
--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' \
--data '{
  "thumbnailKey": "persons/thumbnails/test_profile.jpg"
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드	타입	필수 여부	설명
`code`	String	Required	API 처리 결과 코드
`message`	String	Required	API 처리 결과 메시지
`result`	Object	Required	업로드 상태 결과
`result.uploadStatus`	String	Required	업로드 상태 `COMPLETED` \| `FAILED` `COMPLETED`: 썸네일 이미지 업로드가 정상적으로 완료됨 `FAILED`: 썸네일 이미지 업로드가 실패했으며, 실패 사유는 `uploadMessage` 필드에서 확인 가능
`result.uploadMessage`	String	Optional	업로드 실패 시 사유 `FILE_NOT_EXIST`: 업로드된 파일을 찾을 수 없음 `OVER_SIZE_LIMIT`: 파일 용량이 5MB를 초과함 `RESOLUTION_NOT_SUPPORT`: 이미지 해상도가 최소 조건(256px 이상)을 만족하지 않음 `CAN_NOT_GET_IMAGE_INFO`: 이미지 메타데이터를 불러오는 데 실패함 `IMAGE_CAN_NOT_BE_PREDICTED`: 얼굴 이미지를 찾을 수 없음 `IMAGE_FORMAT_NOT_SUPPORT`: 지원하지 않는 이미지 포맷 (jpg, png, webp 외) `IMAGE_CROP_ERROR`: 크롭 작업 중 오류 발생 (256px 기준 이미지 추출 실패)

응답 상태 코드

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

응답 예시

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

{
  "code": "0",
  "message": "success",
  "result": {
    "uploadStatus": "COMPLETED",
    "uploadMessage": null
  }
}