ARC eye VOT API
- Print
- PDF
ARC eye VOT API
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Overview
The ARC eye Visual Object Tracking (VOT) API returns the result of detecting the object in the image and estimating its pose by passing an image of the object to be estimated.
Prepare API
Convert objects and deploy the API through the VOT app and console. For more information, see the User Guide.
Request
Method | Request URI |
---|---|
POST | Call with the InvokeURL of ARC eye > API > Check API integration key |
Request headers
Name | Description |
---|---|
X-ARCEYE-SECRET | Use the secret key of ARC eye > API > Check API integration key |
Content-Type | multipart/form-data |
Request body
Field name | Required | Data type | Description | Restrictions |
---|---|---|---|---|
image | Y | file | RGB image to perform object detection on | jpg, png |
uuid | Y | string | UUID of the device that took the image | |
timestamp | Y | number | Timestamp of when the image was taken | milliseconds |
intrinsic | Y | string | Camera intrinsic parameters used for object pose estimation | |
distort | Y | string | Camera distortion parameters used for object pose estimation | |
gravity | N | string | Gravity direction used for object pose estimation (calculated from extrinsic if not provided on request) | |
extrinsic | Y | string | Camera pose used for object pose estimation | |
videoid | N | string | videoid recognized from the VOT client | |
imgid | N | string | imgid recognized from the VOT client | |
keyframeid | N | string | keyframeid recognized from the VOT client |
CURL example:
Response
Response body
Field name | Data type | Description |
---|---|---|
result | string | Response result: "SUCCESS", "FAILURE" |
version | string | Version |
uuid | string | Device UUID used in the request |
timestamp | number | Image creation time used on request |
message | string | Detection status message |
status | number | Detection status |
recvtime | number | Point in time when the poser received the request from the detector |
objects | array | Information about the objects used for pose estimation |
object[].projectid | string | projectid for which pose estimation was performed |
object[].poserid | string | videoid (objectid) for which pose estimation was performed |
object[].bbox2d | array(4,2) | Detection ROI for the detector provided for pose estimation |
object[].corners3d | array(9,3) | Coordinates of the 3D object bounding box centered at (0, 0) in 3D space |
object[].corners2d | array(9,2) | Image coordinates corresponding to 3D object bounding box |
object[].intrinsic | array(3,3) | Camera intrinsic parameters used for pose estimation |
object[].distort | array(5) | Camera distortion parameters used for pose estimation |
object[].extrinsic | array(4,4) | Camera pose used for pose estimation |
object[].size | array(3) | Size information for the object [width, height, depth] |
object[].status | boolean | Pose estimation status of the object |
object[].message | string | Pose estimation status information of the object |
Response example
Detection success
Detection failure
Error code
Error response:
Error code | HTTP status | Description |
---|---|---|
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 |
Was this article helpful?