You can use the API to generate AI-powered transcriptions for your recordings. Here we extended BBB API. So, you'll require to follow same procedure as you are doing for BBB API. You can find details from here: https://docs.bigbluebutton.org/development/api/#usage
Here 1 extra API method for this purpose:
1) genRecordingTranscriptions
1) genRecordingTranscriptions
The transcription will be instantly uploaded to the BBB server after it has been generated properly. Later during playback, you'll be able to see the subtitle.
Resource URL:
https://api.mynaparrot.com/XXXX/bigbluebutton/api/genRecordingTranscriptions?[parameters]&checksum=[checksum]
Parameters:
| Param Name | Required/Optional | Type | Description |
|---|---|---|---|
| recordID | Required | String | The record ID which you want to generate transcriptions. |
| locale | Required | String | The primary language spoken throughout the meeting. You can obtain all supported locales from here. |
| label | Required | String | The subtitle label that will appear during playback. Example: English, Spanish, and so on. |
| notifyUrl | Optional | String |
The callback URL in which our system will send POST request with various data. |
Example Requests:
https://api.mynaparrot.com/XXXX/bigbluebutton/api/genRecordingTranscriptions?label=Spanish+%28Spain%29&locale=es-ES¬ifyUrl=https%3A%2F%2Fexample.com%2Fwebhook&recordID=88992c32c319bf439a9123c12ee0a2810b1805a3-1741122799980&checksum=b0c80f6b1a5c29b3c07fc8003bfeae601a89c143Example Response:
<response>
<returncode>SUCCESS</returncode>
<messageKey>statusAccepted</messageKey>
<message>your request has been accepted</message>
</response>
If you have given your notifyUrl value then our system will send in that URL POST request with following information:
| Field name | Type | Possible values |
| event | String | TranscriptionCreation, TranscriptionProcessing, TranscriptionCompletion |
| recordId | String | |
| status | String | Succeeded, Running, Failed, InsufficientBalance, InvalidArgument |
| msg | String |
The subtitle will be immediately added to the recording once it has been generated. Later during playback, you'll notice the option to display subtitles based on the label value you specified during the request. You can also use getRecordingTextTracks API to download subtitles.
Note: Each recording hour costs US$1. Cost is calculated on a per-second basis. The process may take more than 30 minutes.