post
https://api.neuronsinc.com/predict/v2/mixed-media//aois/detect
Automatically detect potential AOIs in a mixed media asset
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Request params
| Field | Type | Required | Description |
|---|---|---|---|
media_id | string (UUID) | Yes | Path parameter. Identifier of the mixed media object. |
No request body is required.
Response 202 Accepted
202 Accepted| Field | Type | Description |
|---|---|---|
detail | string | Confirmation message. Always "AOI detection started". |
AOI detection runs asynchronously. Poll GET /predict/v2/mixed-media/{media_id}/aois/status until aoi_status is done or failed.
If detection is already in progress (aoi_status is started), the endpoint still returns 202 with the same message and does not start a duplicate job.
Other responses
| Status | Description |
|---|---|
| 400 Bad Request | The media exists but is not mixed media. Response body: {"detail": "Media is not mixed media"}. |
| 404 Not Found | No media with this media_id exists for your company. |
Example request
POST /predict/v2/mixed-media/036d5cb3-4fb1-4e88-98e6-1854b607d296/aois/detect
X-API-Key: {your_api_key}Example response
{
"detail": "AOI detection started"
}Typical workflow
- Create and predict mixed media — complete Create Mixed Media (or Create VAST Mixed Media) and Predict Mixed Media until prediction status is
done. - Detect AOIs —
POST /predict/v2/mixed-media/{media_id}/aois/detect(this endpoint). - Poll AOI status —
GET /predict/v2/mixed-media/{media_id}/aois/statusuntilaoi_statusisdone. - Optionally update AOIs with custom regions via
PUT /predict/v2/mixed-media/{media_id}/aois, or use detected AOIs fromGET /predict/v2/media/{media_id}.