VPC 환경에서 이용 가능합니다.
Presigned URL을 통해 검색용 이미지를 업로드한 후, 해당 이미지의 업로드 완료 상태를 확인합니다.
참고
- 호출 제한: 분당 1,000건
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
POST | /api/v1/query-assets/uploads/complete |
요청 헤더
Media AI Understanding API 에서 공통으로 사용하는 헤더에 대한 정보는 Media AI Understanding 요청 헤더를 참조해 주십시오.
요청 경로 파라미터
요청 경로 파라미터는 없습니다.
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
assetKey |
String | Required | 업로드 완료 여부를 확인할 이미지 파일의 키 값
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://maiu.apigw.ntruss.com/api/v1/query-assets/uploads/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 '{
"assetKey": "images/.../query_image.jpg"
}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
code |
String | Required | API 처리 결과 코드 |
message |
String | Required | API 처리 결과 메시지 |
result |
Object | Required | 업로드 상태 결과 |
result
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
assetKey |
String | Required | 업로드된 이미지 파일의 키 값
|
uploadStatus |
String | Required | 업로드 상태
|
uploadMessage |
String | Optional | 업로드 실패 시 상세 메시지
|
응답 상태 코드
Media AI Understanding API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Media AI Understanding 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"code": "0",
"message": "success",
"result": {
"assetKey": "images/.../query_image.jpg",
"uploadStatus": "COMPLETED",
"uploadMessage": null
}
}
참고
- 호출 제한: API는 분당 1,000건까지 호출할 수 있습니다.
- 문의: 호출량 조정이 필요한 경우 고객지원으로 문의해 주십시오.