# CueFrame Media API

**Canonical:** https://apis.io/apis/cueframe-ai/cueframe-ai-media-api/  
**Provider:** CueFrame — https://apis.io/providers/cueframe-ai/  
**Base URL:** https://api.cueframe.ai  
**Documentation:** https://docs.cueframe.ai/docs/api

CueFrame Media API is one of 30 APIs that [CueFrame](https://apis.io/providers/cueframe-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Media. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Media items — uploads, generation, transcripts.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/media/search` | Semantic search over the org's own footage |
| POST | `/v1/media/{id}/processing-runs` | Start a direct hosted processing run |
| GET | `/v1/media/{id}/processing-runs/{runId}` | Read a scoped hosted processing run |
| GET | `/v1/media/{id}/processing-runs/{runId}/artifacts/{operation}` | Get one committed hosted processing artifact |
| POST | `/v1/media/{id}/processing-runs/{runId}/cancel` | Request cancellation of a hosted processing run |
| POST | `/v1/uploads/token` | Mint a short-lived token for the signed upload lane |
| POST | `/v1/media` | Initiate a direct upload (presigned PUT URL) |
| GET | `/v1/media` | List media items |
| POST | `/v1/media/{id}/finalize` | Finalize a direct upload (trigger processing after the bytes are PUT) |
| POST | `/v1/media/generate` | Generate media with AI (video, image, or audio) |
| POST | `/v1/media/import` | Import media from a URL (server-side fetch) |
| DELETE | `/v1/media/{id}` | Delete a media item |
| GET | `/v1/media/{id}` | Get a media item by id |
| GET | `/v1/media/{id}/download-url` | Get a presigned URL for stored media source bytes |
| GET | `/v1/media/{id}/transcript` | Get a media transcript (paginated) |
| GET | `/v1/media/{id}/context` | Get authoring context for a media item (faces + transcript + beat/word grids) |
| POST | `/v1/media/{id}/detect-subjects` | Trigger standalone subject/face detection |
| POST | `/v1/media/{id}/matte` | Buy a behind-subject matte for one source window |
| GET | `/v1/media/{id}/facts` | List derived facts for a media item, with quotes for what is missing |
| POST | `/v1/media/{id}/facts` | Buy a derived fact (subject track or behind-subject matte) |
| POST | `/v1/media/{id}/transcript/analyze` | Analyse a media item's transcript |
| POST | `/v1/timeline-analysis` | Analyze a timeline transcript for edit decisions |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/cueframe-ai/openapi/cueframe-ai-media-api-openapi.yml
- **Documentation** — https://docs.cueframe.ai/docs

## Other CueFrame APIs (12)

- [CueFrame Account API](https://apis.io/apis/cueframe-ai/cueframe-ai-account-api/)
- [CueFrame API Keys API](https://apis.io/apis/cueframe-ai/cueframe-ai-api-keys-api/)
- [CueFrame Billing API](https://apis.io/apis/cueframe-ai/cueframe-ai-billing-api/)
- [CueFrame Brand Kits API](https://apis.io/apis/cueframe-ai/cueframe-ai-brand-kits-api/)
- [CueFrame Briefs API](https://apis.io/apis/cueframe-ai/cueframe-ai-briefs-api/)
- [CueFrame Checkpoints API](https://apis.io/apis/cueframe-ai/cueframe-ai-checkpoints-api/)
- [CueFrame Clips API](https://apis.io/apis/cueframe-ai/cueframe-ai-clips-api/)
- [CueFrame Components API](https://apis.io/apis/cueframe-ai/cueframe-ai-components-api/)
- [CueFrame Compose API](https://apis.io/apis/cueframe-ai/cueframe-ai-compose-api/)
- [CueFrame Compose Session API](https://apis.io/apis/cueframe-ai/cueframe-ai-compose-session-api/)
- [CueFrame Compositions API](https://apis.io/apis/cueframe-ai/cueframe-ai-compositions-api/)
- [CueFrame Consult API](https://apis.io/apis/cueframe-ai/cueframe-ai-consult-api/)

## Tags

Media

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cueframe-ai/cueframe-ai-media-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cueframe-ai/.