media

Buy a behind-subject matte for one source window

Bakes the alpha matte that lets a graphic sit BEHIND the subject for a specific source window. The window is the clip's SOURCE trim (startSec/endSec in seconds into the underlying file), not timeline time, and it is required — a matte's cost scales with its duration. Async: poll GET /media/{id}/facts for the matte fact's status. If a matte for this exact window already exists (bought earlier, or baked by a compose that put a graphic behind the subject) this returns 200 with the existing state and charges NOTHING. summary.presenceFraction on the delivered fact is the viability signal: below 0.6 there is no reliable silhouette, and that matte is delivered free.

post/v1/media/{id}/matte

Request

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

startSecnumber required

Source-in of the window to matte, in seconds into the underlying source.

endSecnumber required

Source-out of the window to matte, in seconds into the underlying source.

Response

Matte bake dispatched (alreadyExisted:false), or the matte already exists (alreadyExisted:true) — in which case nothing was dispatched and nothing will be charged.

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

The server's price for this matte, in USD, quoted from the window duration.

alreadyExistedboolean required

True when a matte for this exact window 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.