media

Buy a derived fact (subject track or behind-subject matte)

Purchases one enhancement for this source. matte REQUIRES intent:{startSec,endSec} — the clip's SOURCE window — because a matte's cost scales with its duration. For subjectTrack the same intent is OPTIONAL: give the clip's source window to buy the track the render will look up for THAT clip (and pay only for its duration); omit it for the whole source. If the fact already exists (pending or ready) this returns it with alreadyExisted:true and charges nothing. Charging happens on DELIVERY, never here: a job that never lands is never billed.

post/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:write)
    • API key in header PAYMENT-SIGNATURE

Path parameters

idstring required

Request body

kind'subjectTrack' | 'matte' required

Which enhancement to buy. transcript is NOT purchasable here — it is delivered by the transcription pipeline.

Response

Fact claimed (dispatched, or already present).

factIdstring required
status'pending' | 'ready' | 'failed' required
quotedUsdnumber required
alreadyExistedboolean required

True when this exact fact was already pending or ready. Nothing was dispatched and nothing will be charged.

Changes

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