Media (Audio/Video)

Re-analyze a media file or text note

Run the Speak Ai analysis again over a record that has already been processed, and replace the insights it produced the first time.

One route covers both kinds of record. Pass the mediaId of an uploaded audio or video file, or the mediaId of a text note, and Speak Ai re-analyzes whichever record the id belongs to.

What the call does

The record moves into the preparingAnalysis state and the analysis runs in the background, so the response comes back before the new insights exist. Poll GET /media/status/{mediaId} to follow it, or subscribe to the media.reanalyzed and text.reanalyzed webhook events.

The query parameters select which parts of the analysis run again. Omit all of them to re-run the default analysis.

get/media/reanalyze/{mediaId}

Request

  • Base URL: https://api.speakai.co/v1
  • URL: https://api.speakai.co/v1/media/reanalyze/{mediaId}
  • Auth: API key in header x-speakai-key and API key in header x-access-token

Path parameters

mediaIdstring required

Id of the media file or text note to re-analyze.

Query parameters

isInsightsboolean

Re-run insight extraction.

isSentimentboolean

Re-run sentiment analysis.

isFillerWordsboolean

Re-run filler word detection.

isEmbeddingsboolean

Rebuild the embeddings used by AI chat.

Response

OK

statusstring
messagestring

Changes

No recorded changes to this operation across all 2 revisions of this API.