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

Mixed 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`

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 receive media_id and resumable_url.
Upload the file — PUT the binary to resumable_url.
Predict mixed media — PUT /predict/v2/mixed-media/{media_id}/predict.
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.

201Created

400Bad Request

401Unauthorized

404Not Found

412Precondition Failed

422Unprocessable Content

500Internal Server Error

502Bad Gateway