Transcribe Recording
Generate the transcription for a specific recording. Transcription can succeed only for recordings of length greater than 500 milliseconds and less than 4 hours.
Request URL
POST
https://voice.bandwidth.com/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription
Basic Authentication
Bandwidth's Voice API leverages Basic Authentication with your Dashboard API Credentials. Read more about how Bandwidth secures endpoints in the Security & Credentials document.
Supported Parameters
Parameter | Description | Mandatory |
---|---|---|
callbackUrl | The URL to send the TranscriptionAvailable event to. You should not include sensitive or personally-identifiable information in the callbackUrl field! Always use the proper username and password fields for authorization. | No |
callbackMethod | The HTTP method to use for the request to callbackUrl . GET or POST. Default value is POST. |
No |
username | The username to send in the HTTP request to callbackUrl . |
No |
password | The password to send in the HTTP request to callbackUrl . |
No |
tag | A custom string that will be sent with this callbacks. | No |
Example 1 of 1: Transcribe a recording
curl -X POST \
--url 'https://voice.bandwidth.com/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription' \
-u '{username}:{password}' \
-H 'Content-type: application/json' \
--data-raw '
{
"callbackUrl" : "https://www.myapp.com/transcription"
}'
Responds
HTTP/1.1 204
ApiTranscribeRecordingRequest requestBody = new ApiTranscribeRecordingRequest();
requestBody.setCallbackUrl("https://example.server.com");
ApiResponse<Void> response = controller.createTranscribeRecording(accountId, callId, recordingId, requestBody);
var apiTranscribeRecordingRequest = new ApiTranscribeRecordingRequest
{
CallbackUrl = "https://example.com"
};
controller.CreateTranscribeRecording(accountId, callId, recordingId, apiTranscribeRecordingRequest);
body = ApiTranscribeRecordingRequest.new
body.callback_url = "https://www.myapp.com/transcription"
voice_client.create_transcribe_recording(VOICE_ACCOUNT_ID, call_id, recording_id, :body => body)
body = ApiTranscribeRecordingRequest()
body.callback_url = "https://www.myapp.com/transcription"
voice_client.create_transcribe_recording(VOICE_ACCOUNT_ID, call_id, recording_id, body=body)
var body = new BandwidthVoice.ApiTranscribeRecordingRequest({
"callbackUrl": "https://www.myapp.com/transcription"
});
await voiceController.createTranscribeRecording(accountId, callId, recordingId, body);
$body = new BandwidthLib\Voice\Models\ApiTranscribeRecordingRequest();
$body->callbackUrl = "https://www.myapp.com/transcription";
$voiceClient->createTranscribeRecording($accountId, $callId, $recordingId, $body);