Object Tracking
studio-object-trackingTrack a marked object through every scene of a video (async).
Send the video URL, the second where the object is clearly visible, a box around it in percent and its short English name. The object is found in every scene of the searched range and tracked frame by frame. The result lists the appearances and, for each frame, the box (and with outputType polygon, the outline points), all in percent of the frame.
POST
/v1/proxy/studio-object-trackingObject tracking (async)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
videoUrl | string | required | Source video URL |
time | number | required | Second where the box is drawn |
box | object | required | {x, y, w, h} in percent |
objectName | string | required | Short English name with color |
startTime | number | optional | Range start (s) |
endTime | number | optional | Range end (s), max range 600 s |
outputType | string | optional | box (default) or polygon |
curl -X POST https://api.cn8.io/v1/proxy/studio-object-tracking \
-H "X-API-Key: <cn8_api_key>" \
-H "Content-Type: application/json" \
-d '{"videoUrl":"https://example.com/file","time":1,"box":{},"objectName":"my-resource"}'Response
{
"status": "accepted",
"job": { "id": "45a75e98-18ae-4bd1-bc2e-f166b76341c5", "status": "queued" }
}
Poll GET /v2/jobs/{id} until completed; the frames are in result_data.data. Billed per second of the searched range.