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.

curl -X POST "https://example.com/v1/media/string/transcript/analyze" \  -H "Content-Type: application/json" \  -d '{    "task": "summary"  }'

{  "task": "summary",  "result": "string",  "model": "string"}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}