---
title: "Point cloud detection"
method: POST
path: "/pointCloud/detection"
tags: ["Plugin API/Model/Point Cloud"]
---

# Point cloud detection

`POST /pointCloud/detection`

This API integrates your object detection model into BasicAI. This API only works with Point Cloud data in LiDAR Fusion

## Headers

- `Authorization` string

## Request body

- object
  - `data` PointCloudModelData, required
    - `id` integer, required — ID
    - `pointCloudUrl` string, required — The URL of PointCloud
    - `cameraImageUrls` string[] — the array of the URLs of camera images
    - `cameraConfigUrl` string — The URL of camera config

## Response `200`

Successful

- object
  - `code` string, required — Error code, OK indicates success, while others indicate failure
  - `message` string, required — Error message
  - `data` object, required
    - `objects` PointCloudModelBoundingBoxObject[], required — The array of detected objects, will be empty if there is none.
      - `score` number, required — Range [0, 1]
      - `label` string, required — String of Label or Class, case sensitive
      - `contour` object, required — Contour infomation of bbox，If empty, related QA will not be supported.
        - `x` number, required — Center point coordinate X
        - `y` number, required — Center point coordinate Y
        - `z` number, required — Center point coordinate Z
        - `dx` number, required — Length of the X-axis
        - `dy` number, required — Length of the Y-axis
        - `dz` number, required — Length of the Z-axis
        - `rotx` number, required — Angle of rotation around the X-axis, right-hand coordinate system
        - `roty` number, required — Angle of rotation around the Y-axis, right-hand coordinate system
        - `rotz` number, required — Angle of rotation around the Z-axis, right-hand coordinate system
      - `minDistance` number — Takes the nearest point for the shortest distance from the origin on the XY plane.
      - `maxDistance` number — Takes the furthest point for the furthest distance from the origin on the XY plane
      - `minHeight` number — Takes the lowest point on the Z-axis for the minimum height.
      - `maxHeight` number — Takes the highest point on the Z-axis for the maximum height
      - `pointCount` integer — The points inside the cuboid

---

[API](https://skmtc.dev/basic/apis/basicai-cloud-open-plugin-api.md) · [All operations](https://skmtc.dev/basic/apis/basicai-cloud-open-plugin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basic/basicai-cloud-open-plugin-api/revisions/f6b5a226c6da/schema)