media

List derived facts for a media item, with quotes for what is missing

The enhancement menu. facts is everything expensive we have already computed about this source — subject tracks, mattes — with its status, a small summary a caller can act on without fetching the artifact, and charge (what it was billed; absent when it cost nothing, e.g. a matte produced as a side effect of a compose you already paid for, or one delivered below the behind-subject presence floor). offers is what is NOT present yet, with a real server quote. A matte is offered ONLY when you pass startSec+endSec — the clip's SOURCE window — because a matte's price is a function of its duration and a whole-source quote for a three-second clip is not a price. Pass the window from the editor and you get a per-clip matte quote plus the status of that window's matte; omit it from the library and you get everything except the matte.

get/v1/media/{id}/facts

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/media/{id}/facts
  • 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

Path parameters

idstring required

Query parameters

kind'subjectTrack' | 'matte'

Resolve one exact editor prerequisite. Requires startSec and endSec; the response includes the server-selected exact result.

startSecnumber

Source-in of the clip's trim, in seconds. Must be sent WITH endSec — one without the other is a 400, never a silent whole-source default.

endSecnumber

Source-out of the clip's trim, in seconds. Must be sent WITH startSec.

Response

Facts + offers.

Changes

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