media

Semantic search over the org's own footage

Find MOMENTS in your library by describing what they look like. The query uses the same visual-semantic index as the footage, so it matches on visual content — "wide shot of a speaker at a whiteboard", "hands on a keyboard", "city skyline at dusk" — including shots nobody talks about (which is where transcript search fails). Results are time-ranged: feed mediaId + startSec/endSec straight into apply_composition as a clip. q is required; limit defaults to 10 and caps at 25. indexing reports missing chunks observed in a bounded membership window; false does not prove complete coverage. Inspect coverage for scope and limits. Empty results mean retrieval returned no hits, not that no suitable footage exists. Optional repeated mediaId parameters restrict retrieval before top-k truncation (maximum 32).

get/v1/media/search

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/media/search
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: media:read)
    • API key in header PAYMENT-SIGNATURE

Query parameters

projectIdstring

Restrict search to project membership before ranking.

mediaIdstring[]

Optional explicit media scope, applied before candidate truncation. Up to 32 distinct IDs.

qstring required

What the moment should look like, in plain language. Describe the IMAGE, not the words spoken.

limitinteger

Maximum moments to return. Default 10, maximum 25.

Response

Matching moments, best first.

indexingboolean required

Missing chunks observed in the bounded coverage window; false does not establish whole-library completeness.

Changes

No recorded changes to this operation across all 1 revision of this API.