Sizes, rates and quotas of the Space Context API: uploads, requests per minute, daily search and question limits, scans at once, account and result limits.
MCP server An assistant reads your spaces themselves, not only the docs.
Uploads
Limit
Video
MP4, MOV, M4V, 3GP, WebM or Matroska; up to 4 GB and 10 minutes (the duration read from the file)
Video through the API (when no direct upload link is offered)
95 MB: a bigger video goes to the direct upload link
Photos per scan
120, JPEG, PNG or WebP, 2 MB each
Transcript
600 segments of up to 2 000 characters
Direct upload link
Valid 1 hour
Time to start a scan after creating it
24 hours, then it is cancelled
GET /v1 states the limits of the deployment it answers for in limits (max_video_bytes, max_video_seconds, max_photos); the SDK, the CLI and the console read them there, take a deployment that does not state them to accept 100 MB, and check nothing when they cannot be read (the API then decides when the scan is declared). Ten minutes of a phone’s default 1080p recording come to about 1.2 GB. On a slow connection, the CLI re-encodes a video to a smaller file before uploading it (--compress) when ffmpeg is installed.
Rates
Limit
Requests per key
120 per minute
Requests per IP address
1 200 per minute
Search
20 per minute and 1 000 per day per account
Questions (ask)
20 per minute and 200 answered per day per account
Frame checks (POST /frames/check)
2 000 per day per account (free)
Agent payments (POST /agent/credits)
5 per minute per IP address; $1 to $500 per payment
Scans processing at once
10 per account; more on request
New spaces (POST /spaces)
200 per day per account, in each mode (test keys included)
New scans (POST /spaces/{id}/scans)
500 per day per account, in each mode (test keys included)
Event streams (GET /scans/{id}/events) open at once
10 per account, test and live together
Event streams opened
20 per minute per account
Event stream length
30 minutes per connection; reconnect to keep following
Evidence frames
Signed links expire; read the document again for fresh ones
Exceeding a rate answers 429 RATE_LIMIT_EXCEEDED with the seconds to wait in retry_after, and in the Retry-After header too for per-minute limits, new spaces and scans, and event streams:
Daily limits reset at midnight UTC. New spaces and new scans answer with the time left until then and their allowance in daily_limit; a retry with the same Idempotency-Key (scans) or external_id (spaces) returns what was already created and does not count again. Search, questions and frame checks answer retry_after: 3600.
Event streams: with 10 open, the next one answers Retry-After: 30 and max_streams: 10. Close one, or poll GET /scans/{id} meanwhile; the SDK, the CLI and the MCP server do this for you.