Predict Mixed Media

Time	Status	User Agent
Retrieving recent requests…

Request params

Field	Type	Required	Description
`media_id`	string (UUID)	Yes	Path parameter. Identifier of the mixed media object returned by Create Mixed Media or Create VAST Mixed Media.

No request body is required.

Field	Type	Description
`media_id`	string (UUID)	Identifier of the mixed media object. Same as the `media_id` in the request path.

Prediction runs asynchronously. Poll GET /predict/v2/media/{media_id} to track status (init, started, done, or failed).

Status	Description
202 Accepted	Prediction is already in progress. Response body: `{"detail": "Prediction already started"}`.
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.

PUT /predict/v2/mixed-media/036d5cb3-4fb1-4e88-98e6-1854b607d296/predict
X-API-Key: {your_api_key}

{
  "media_id": "036d5cb3-4fb1-4e88-98e6-1854b607d296"
}

If prediction is already running:

{
  "detail": "Prediction already started"
}

(Status 202.)

Create mixed media — Create Mixed Media or Create VAST Mixed Media.
Upload the file (manual upload only) — PUT the binary to resumable_url, or wait for VAST capture to finish.
Predict mixed media — PUT /predict/v2/mixed-media/{media_id}/predict (this endpoint).
Poll media status — GET /predict/v2/media/{media_id} until prediction status is done.
Optionally configure objectives, AOIs, benchmark ranges, and impact score via the shared Media endpoints.

If the asset was predicted before (status is done), calling this endpoint again re-runs prediction and frame-level metrics (FRT).