Upload a video
Upload
Upload Video — from File
Upload a video file (multipart)
POST
Upload a video
Product: Video Datalake
Host:
https://api.memories.ai/datalake/v1
Auth: Authorization: sk-mai-...multipart/form-data: a json part (common fields, no source_url) plus a file part. Returns 202 + video_id + operation.
Pricing: $0.04 / minute of indexed video · See Pricing for the full model.
Response Fields
string
New video ID.
string
Ingest Operation handle.
Notes
Non-video extensions return 415 unsupported_media.Authorizations
Send Authorization: sk-mai-...
Query Parameters
Set to resumable to start a chunked upload session for large files.
Available options:
resumable Body
Target collection. The video inherits its embedding model / detectors / face config.
URL mode only: a public direct link. Platform links (YouTube/TikTok) fail with source_unresolved.
Sampling frame rate [0.1, 30]. Default 1.0.
ISO-8601 capture time (falls back to video EXIF).
{title, tags:[], custom:{}}. Set title to the original filename.
HTTPS webhook, ≤512 chars, fired on completion.
≤128 chars. Same key re-submits the existing video.
Response
200 - application/json
Accepted
