media

Finalize a direct upload (trigger processing after the bytes are PUT)

Required permission: media:write

post/v1/media/{id}/finalize

Request

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

audioRole'vo' | 'music' | 'sfx' | 'ambience'

Declared audio role: 'vo' (narration), 'music' (bed that ducks under speech), 'sfx' (one-shot hit), 'ambience' (a bed that HOLDS under VO — never ducks).

Response

Ingest triggered.

idstring required
status'processing' | 'complete' required
processingPhasestring required

Changes

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