Analyse a media item's transcript
Ask ONE editorial question of a transcript and get the answer as text: summary (what is actually said, plus the takeaways), chapters (where the subject changes), or highlights (the moments that stand alone as a short). PRECISION: timestamps are ABSOLUTE seconds from the start of the media and every one is verified against the transcript before you see it (a fabricated timestamp fails the call rather than shipping) — but they are LINE-START markers roughly 15s apart, so a boundary can sit up to 15s BEFORE the moment you asked for. Treat every span as APPROXIMATE: use it to LOCATE the moment, then refine the in/out against the word timings from GET /v1/media/{id}/context before you cut. Feeding a raw span straight into a clip trim will start it mid-sentence. Pass window to analyse one slice; omit it for the whole thing. This is a METERED LLM call, not a read: it bills on measured token spend, and a recording too long to analyse in one pass is rejected with 422 transcript_too_long (over ~100k characters, roughly two hours of speech) rather than silently summarising only its first half — narrow it with window. 422 media_no_transcript means the item has no speech on file (or none inside your window); GET /v1/media/{id}/context shows transcript state, and GET /v1/media/{id}/transcript returns the raw words.
Request
- Base URL: https://api.cueframe.ai
- URL: https://api.cueframe.ai/v1/media/{id}/transcript/analyze
- 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
Request body
Response
The analysis.
Changes
No recorded changes to this operation across all 1 revision of this API.