MENU
      ARC eye VOT API
        • PDF

        ARC eye VOT API

        • PDF

        기사 요약

        개요

        ARC eye Visual Object Tracking (VOT) API 는 추정할 오브젝트가 촬영된 이미지를 전달하여 이미지에서 오브젝트를 검출한 결과와 포즈를 추정한 결과를 반환합니다.

        API 준비

        VOT앱과 콘솔을 통해 오브젝트를 변환하고 API 를 배포합니다. 자세한 내용은 사용가이드 를 참조하세요.

        요청

        메서드요청 URI
        POSTARC eye > API > API 연동 키 확인 의 InvokeURL 로 호출

        요청 헤더

        이름설명
        X-ARCEYE-SECRETARC eye > API > API 연동 키 확인 의 Secret Key 사용
        Content-Typemultipart/form-data

        요청 바디

        필드이름필수여부데이터유형설명제약사항
        imageYfile오브젝트 검출을 수행할 RGB 이미지jpg, png
        uuidYstring이미지를 촬영한 디바이스의 uuid
        timestampYnumber이미지 촬영 시점의 timestampmilliseconds
        intrinsicYstring오브젝트 포즈 추정에 사용된 카메라 intrinsic 파라미터
        distortYstring오브젝트 포즈 추정에 사용된 카메라 distortion 파라미터
        gravityNstring오브젝트 포즈 추정에 사용된 중력 방향 (요청시 제공되지 않으면 extrinsic으로부터 계산된 값)
        extrinsicYstring오브젝트 포즈 추정에 사용된 카메라 포즈
        videoidNstringVOT client 에서 인식된 videoid
        imgidNstringVOT client 에서 인식된 imgid
        keyframeidNstringVOT client 에서 인식된 keyframeid

        CURL example:

        curl -X POST '{invokeUrl}' \
        -H 'X-ARCEYE-SECRET: {secretKey}' \
        -H 'Content-Type: multipart/form-data' \
        -F 'image=@object.jpg \
        -F 'uuid=a4315b63-2d64-11ef-becb-005056a70a22' \
        -F 'timestamp=1718709558076' \
        -F 'intrinsic=1524.3942260742188,0.0,539.0464782714844,0.0,1524.3942260742188,950.2188720703125,0.0,0.0,1.0' \
        -F 'distort=0.0,0.0,0.0,0.0,0.0' \
        -F 'extrinsic=-0.5501050024473961,-0.03056710354932507,-0.834535882070361,-0.2494854635652485-0.42819610313094764,0.8682865385146257,0.25045275861479593,-0.16543658916848714,0.7169606569023306,,0.495120328016226,-0.4907374830184501,0.189104661569504620.0,0.0,0.0,1.0'
        Bash

        응답

        응답바디

        필드이름데이터유형설명
        resultstring응답결과 : "SUCCESS", "FAILURE"
        versionstring버전
        uuidstring요청시 사용된 디바이스 uuid
        timestampnumber요청시 사용된 이미지 생성시간
        messagestring검출 상태 메시지
        statusnumber검출 상태
        recvtimenumberPoser에서 Detector의 요청을 수신한 시점
        objectsarray포즈 추정에 사용된 오브젝트 정보
        object[].projectidstring포즈 추정을 수행한 projectid
        object[].poseridstring포즈 추정을 수행한 videoid(objectid)
        object[].bbox2darray(4,2)포즈 추정을 위해 제공된 detector의 검출 roi
        object[].corners3darray(9,3)3D 공간에서 (0,0)을 중심으로한 3D object bounding box의 좌표
        object[].corners2darray(9,2)3D object bounding box에 대응되는 image 좌표
        object[].intrinsicarray(3,3)포즈 추정에 사용된 카메라 intrinsic 파라미터
        object[].distortarray(5)포즈 추정에 사용된 카메라 distortion 파라미터
        object[].extrinsicarray(4,4)포즈 추정에 사용된 카메라 포즈
        object[].sizearray(3)오브젝트의 크기 정보 [width, height, depth]
        object[].statusboolean오브젝트의 포즈 추정 상태
        object[].messagestring오브젝트의 포즈 추정 상태 정보

        응답 예시

        검출성공

        {
            "result": "SUCCESS",
            "version": "3.0.0-1",
            "projectid": "123",
            "recvtime": 1712213062.4720848,
            "timestamp": 1712213062.2513185,
            "uuid": "933ec42646f8",
            "status": 0,
            "message": "VOT_DETECTOR_SUCCESS",
            "objects": [
                {
                    "bbox2d": [[677.0, 1472.0], [1466.0, 1472.0], [1466.0, 2861.0], [677.0, 2861.0]],
                    "conf_thresh": 0.3,
                    "corners2d": [[1048, 2119], [746, 2513], [726, 1473], [715, 2864], [686, 1564], [1297, 2500], [1335, 1477], [1408, 2842], [1472, 1568]],
                    "corners3d": [[0.0, 0.0, 0.0],
                        [-0.29031120781734804, -0.5381274223327637, -0.3174518426978675],
                        [-0.29031120781734804, 0.5381274223327637, -0.3174518426978675],
                        [-0.29031120781734804, -0.5381274223327637, 0.3174518426978675],
                        [-0.29031120781734804, 0.5381274223327637, 0.3174518426978675],
                        [0.29031120781734804, -0.5381274223327637, -0.3174518426978675],
                        [0.29031120781734804, 0.5381274223327637, -0.3174518426978675],
                        [0.29031120781734804, -0.5381274223327637, 0.3174518426978675],
                        [0.29031120781734804, 0.5381274223327637, 0.3174518426978675]],
                    "distort": [0.0, 0.0, 0.0, 0.0, 0.0],
                    "extrinsic": [[-0.2429226121477801, -0.2506293885132776, 0.9371091260471003, 0.0],
                        [-0.009911837278829036, 0.9666372782061301, 0.2559572774195017, 0.0],
                        [-0.9699950309094669, 0.05288933725909484, -0.23730225033748942, 0.0],
                        [0.012476532015234023, 0.021933435026800476, 0.024992155870001847, 1.0]],
                    "global_pose": [[1.0, 0.0, 0.0, 0.0],
                        [0.0, 1.0, 0.0, 0.0],
                        [0.0, 0.0, 1.0, 0.0],
                        [0.0, 0.0, 0.0, 1.0]],
                    "global_prob": 1.0,
                    "intrinsic": [[2834.314, 0.0, 1093.1019], [0.0, 2834.314, 1933.7009], [0.0, 0.0, 1.0]],
                    "message": "VOT_OBJECT_POSE_SUCCESS",
                    "obj_prob": 1.0,
                    "objid": "rookie",
                    "pose": [[0.9968414902687073, 0.014719659462571144, 0.0780409649014473, -0.03976171463727951],
                        [-0.006204552017152309, -0.9652349948883057, 0.26131001114845276, 0.16608235239982605],
                        [0.07917426526546478, -0.2609688639640808, -0.9620949625968933, 2.5332860946655273],
                        [0.0, 0.0, 0.0, 1.0]],
                    "poserid": "14dfc56c-a640-4281-9e95-aa49b61d51bd",
                    "projectid": "b385865f-67f3-4341-aca5-166d20df952b",
                    "sim_prob": 0.9999999255277782,
                    "size": [0.5806224156346961, 1.0762548446655273, 0.634903685395735],
                    "status": True,
                    "type": "normal"
                }
            ]
        }
        JSON

        검출실패

        {
          "result": "FAILURE",
          "running_time": {
            "processing": 2
          },
          "timestamp": 1718709558076,
          "version": "3.0.0-1",
          "candidate_obj_id": 0
        }
        JSON

        에러코드

        에러응답:

        {
          "code": "9999",
          "message": "Unknown server error.",
          "path": "path",
          "product": "ARC eye",
          "traceId": "9c1f55ac7d8341d792a922b2590c045f",
          "timestamp": 1570776853475,
          "status": "500"
        }
        JSON
        에러코드HTTP 상태설명
        0001404Not Found
        0020401Unauthorized
        0030403Forbidden
        010040xInvalid Parameter
        0101409Duplicate
        100050xInternal API Error
        1001500Processing Error
        9999500Unknown Error

        이 문서가 도움이 되었습니까?

        What's Next
        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.