ARC eye VOT API
- 인쇄
- PDF
ARC eye VOT API
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
ARC eye Visual Object Tracking (VOT) API 는 추정할 오브젝트가 촬영된 이미지를 전달하여 이미지에서 오브젝트를 검출한 결과와 포즈를 추정한 결과를 반환합니다.
API 준비
VOT앱과 콘솔을 통해 오브젝트를 변환하고 API 를 배포합니다. 자세한 내용은 사용가이드 를 참조하세요.
요청
메서드 | 요청 URI |
---|---|
POST | ARC eye > API > API 연동 키 확인 의 InvokeURL 로 호출 |
요청 헤더
이름 | 설명 |
---|---|
X-ARCEYE-SECRET | ARC eye > API > API 연동 키 확인 의 Secret Key 사용 |
Content-Type | multipart/form-data |
요청 바디
필드이름 | 필수여부 | 데이터유형 | 설명 | 제약사항 |
---|---|---|---|---|
image | Y | file | 오브젝트 검출을 수행할 RGB 이미지 | jpg, png |
uuid | Y | string | 이미지를 촬영한 디바이스의 uuid | |
timestamp | Y | number | 이미지 촬영 시점의 timestamp | milliseconds |
intrinsic | Y | string | 오브젝트 포즈 추정에 사용된 카메라 intrinsic 파라미터 | |
distort | Y | string | 오브젝트 포즈 추정에 사용된 카메라 distortion 파라미터 | |
gravity | N | string | 오브젝트 포즈 추정에 사용된 중력 방향 (요청시 제공되지 않으면 extrinsic으로부터 계산된 값) | |
extrinsic | Y | string | 오브젝트 포즈 추정에 사용된 카메라 포즈 | |
videoid | N | string | VOT client 에서 인식된 videoid | |
imgid | N | string | VOT client 에서 인식된 imgid | |
keyframeid | N | string | VOT client 에서 인식된 keyframeid |
CURL example:
응답
응답바디
필드이름 | 데이터유형 | 설명 |
---|---|---|
result | string | 응답결과 : "SUCCESS", "FAILURE" |
version | string | 버전 |
uuid | string | 요청시 사용된 디바이스 uuid |
timestamp | number | 요청시 사용된 이미지 생성시간 |
message | string | 검출 상태 메시지 |
status | number | 검출 상태 |
recvtime | number | Poser에서 Detector의 요청을 수신한 시점 |
objects | array | 포즈 추정에 사용된 오브젝트 정보 |
object[].projectid | string | 포즈 추정을 수행한 projectid |
object[].poserid | string | 포즈 추정을 수행한 videoid(objectid) |
object[].bbox2d | array(4,2) | 포즈 추정을 위해 제공된 detector의 검출 roi |
object[].corners3d | array(9,3) | 3D 공간에서 (0,0)을 중심으로한 3D object bounding box의 좌표 |
object[].corners2d | array(9,2) | 3D object bounding box에 대응되는 image 좌표 |
object[].intrinsic | array(3,3) | 포즈 추정에 사용된 카메라 intrinsic 파라미터 |
object[].distort | array(5) | 포즈 추정에 사용된 카메라 distortion 파라미터 |
object[].extrinsic | array(4,4) | 포즈 추정에 사용된 카메라 포즈 |
object[].size | array(3) | 오브젝트의 크기 정보 [width, height, depth] |
object[].status | boolean | 오브젝트의 포즈 추정 상태 |
object[].message | string | 오브젝트의 포즈 추정 상태 정보 |
응답 예시
검출성공
검출실패
에러코드
에러응답:
에러코드 | HTTP 상태 | 설명 |
---|---|---|
0001 | 404 | Not Found |
0020 | 401 | Unauthorized |
0030 | 403 | Forbidden |
0100 | 40x | Invalid Parameter |
0101 | 409 | Duplicate |
1000 | 50x | Internal API Error |
1001 | 500 | Processing Error |
9999 | 500 | Unknown Error |
이 문서가 도움이 되었습니까?