Live Transcription

Create a live transcription session

Create the media record that a live transcription session writes into, and get back the mediaId the streaming connection needs.

Call this first. The record is created in the liveTranscript state with its processing progress already at 100, so it appears in the folder straight away and fills with words as the session runs.

Every field in the body is optional. When folderId is left out, Speak Ai stores the record in the first folder on the account.

Sessions that already exist

Pass meetingAssistantId to attach the session to a scheduled meeting assistant event. When that event already has a media record, Speak Ai returns the existing mediaId instead of creating a second one, so the call is safe to repeat.

post/live-transcription/create

Request

  • Base URL: https://api.speakai.co/v1
  • URL: https://api.speakai.co/v1/live-transcription/create
  • Auth: API key in header x-speakai-key and API key in header x-access-token

Request body

namestring

Name for the media record. A meeting assistant event overrides this with its own title.

mediaTypestring

Recording MIME type, for example audio/webm or video/mp4. Speak Ai keeps the part before the slash, and stores anything it does not recognise as audio.

sourceLanguagestring

Language code for the session. Defaults to en-us.

folderIdstring

Folder to store the record in. Defaults to the first folder on the account.

tagstring

Single tag stored on the record.

meetingAssistantIdstring

Id of a scheduled meeting assistant event to attach the session to.

recorderTokenstring

Token of a recorder, when the session comes from an embedded recorder. Speak Ai then takes the folder and the source language from the recorder.

Response

OK

statusstring

Changes

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