Sync-Annotation

Developing

POST

/api/v1/miri/annotation

Requests annotation for a single PCD file and returns the annotation results in the response.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://vuex.dev.vueron.ai/api/v1/miri/annotation' \
--header 'X-Header-API-Key: ai_annotation.78.9LysjYtTHu2oKmBzg8a3' \
--header 'X-Tenant-ID: 5b7eee8c-e9b5-48e6-87e0-d738c2e8a618' \
--header 'Content-Type: application/json' \
--data '{
    "modelingID": "5",
    "presignedURL": [
        "https://vuex-dev.s3.ap-northeast-2.amazonaws.com/5b7eee8c-e9b5-48e6-87e0-d738c2e8a618/2025_12_05_14_28_07/2025_12_05_14_28_07.pcd/000001.pcd?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Checksum-Mode=ENABLED&X-Amz-Credential=AKIATABHAUBASOXBNQV2%2F20260415%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20260415T051236Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=4892a4b8de86356fa6a85243bb310915d6850b73565635b9d56f3edea3867ab2"
    ],
    "distance": 150,
    "useSession": true
}'

Response Example

{
    "trID": "20260116053522690568",
    "resultCode": "0200",
    "resultMsg": "APIAnnotationSync",
    "resultData": {
        "filename": "000001",
        "description": "",
        "key": "3d1a809b-94de-474e-94fb-1c8237541faf",
        "tags": [
            {
                "key": "6be47f93-8743-4666-82b4-6f15ebd723b8",
                "name": "name",
                "value": "20260116053522690568",
                "labelerLogin": "20260116053522690568",
                "createdAt": "2026-01-16T05:35:22Z",
                "updatedAt": "2026-01-16T05:35:22Z"
            },
            {
                "key": "ed519536-6f4b-43ae-a0f8-4f16c0f760d0",
                "name": "labels",
                "value": [
                    {
                        "label_id": "1",
                        "color": "#e1737a",
                        "name": "Car",
                        "alias": "Passenger Vehicle",
                        "type": "any"
                    }
                ],
                "labelerLogin": "20260116053522690568",
                "createdAt": "2026-01-16T05:35:22Z",
                "updatedAt": "2026-01-16T05:35:22Z"
            }
        ],
        "objects": [
            {
                "key": "b64dd538-15e2-46f1-b565-6309b9f505b2",
                "label_id": "1",
                "classTitle": "Car",
                "alias": "",
                "tags": [
                    {
                        "key": "b66e4f9a-f296-4bf1-a514-02616dd39d6d",
                        "name": "occluded",
                        "value": "false",
                        "labelerLogin": "20260116053522690568",
                        "createdAt": "2026-01-16T05:35:22Z",
                        "updatedAt": "2026-01-16T05:35:22Z"
                    }
                ],
                "labelerLogin": "20260116053522690568",
                "createdAt": "2026-01-16T05:35:22Z",
                "updatedAt": "2026-01-16T05:35:22Z"
            }
        ],
        "figures": [
            {
                "key": "7733d243-4108-47f3-a98a-cca0b7a6fad7",
                "objectKey": "b64dd538-15e2-46f1-b565-6309b9f505b2",
                "geometryType": "cuboid_3d",
                "geometry": {
                    "position": {
                        "x": -3.285430908203125,
                        "y": 5.196868896484375,
                        "z": 0.8905813694000244
                    },
                    "dimension": {
                        "x": 4.799823760986328,
                        "y": 2.152639389038086,
                        "z": 1.7482513189315796
                    },
                    "rotation": {
                        "x": 0,
                        "y": 0,
                        "z": 0.02734098583459854
                    }
                },
                "labelerLogin": "20260116053522690568",
                "class": "Car",
                "alias": "",
                "confidence": 0.8999999761581421,
                "createdAt": "2026-01-16T05:35:22Z",
                "updatedAt": "2026-01-16T05:35:22Z",
                "trackId": "2601160535491990001"
            }
        ]
    }
}

Modified at 2026-04-15 07:22:35

API Annotation User Guide

Bulk-Annotation