media

Import media from a URL (server-side fetch)

Import media into the project from a public https URL — the server fetches and mirrors the bytes (SSRF-filtered), then processes video and audio. Async: returns a media id that flips to ready when the mirror and processing finish; poll GET /media/:id or use a media.completed webhook.

post/v1/media/import

Request

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

Request body

urlstring uri required
filenamestring required
contentType'video/mp4' | 'video/quicktime' | 'video/x-matroska' | 'video/webm' | 'audio/mpeg' | 'audio/wav' | 'audio/x-wav' | 'audio/mp4' | 'audio/aac' | 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif' | 'image/svg+xml' | 'application/json' | 'font/ttf' | 'font/otf' | 'font/woff' | 'font/woff2' required
sizeinteger
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

Import enqueued.

idstring required
status'importing' required

Changes

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