Create a Mixed Media object in the system and returns a resumable url to upload the asset
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Request params
| Field | Type | Required | Description |
|---|---|---|---|
content_type | string | Yes | MIME type of the mixed media file (case-insensitive). See Supported content_type values below. |
total_bytes | integer | Yes | Size of the file in bytes. Must not exceed the file size limit. |
Supported content_type values
content_type valuesMixed media accepts standard video formats plus GIF:
| MIME type | Format |
|---|---|
video/mp4 | MP4 |
video/webm | WebM |
video/quicktime | MOV |
video/x-matroska | MKV |
video/avi | AVI |
image/gif | GIF |
Other image types (for example image/png) are not accepted.
File size limit
The maximum upload size is the same as for videos (MAX_VIDEO_BYTES, configured per environment). If the file exceeds this limit, the API returns 412 with:
Max file bytes size: {MAX_VIDEO_BYTES}Maximum allowed resolution: 3000x3000
Response 201 Created
201 Created| Field | Type | Description |
|---|---|---|
resumable_url | string | Google Cloud Storage resumable upload URL. Upload the file with HTTP PUT to this URL before starting prediction. |
media_id | string (UUID) | Identifier of the created mixed media object. Use this in later calls (predict, AOIs, objectives, impact score, etc.). |
Example request
{
"content_type": "video/mp4",
"total_bytes": 953311
}GIF example:
{
"content_type": "image/gif",
"total_bytes": 512000
}Example response
{
"resumable_url": "https://storage.googleapis.com/...",
"media_id": "036d5cb3-4fb1-4e88-98e6-1854b607d296"
}Typical workflow
-
Create mixed media —
POST /predict/v2/mixed-media. You receivemedia_idandresumable_url. -
Upload the file —
PUTthe binary toresumable_url. -
Predict mixed media —
PUT /predict/v2/mixed-media/{media_id}/predict. -
Poll media status —
GET /predict/v2/media/{media_id}until prediction status isdone. -
Optionally configure objectives, AOIs, benchmark ranges, and impact score via the shared Media endpoints.