POST Audio API
The Async Audio API allows you to process an audio file.
It can be utilized for any use case where you have access to recorded audio and want to extract insights and other conversational attributes supported by Symbl's Conversation API.
Use this API to upload your file and generate a Conversation ID. If you want to append additional audio information to the same Conversation ID
#
HTTP REQUESTPOST https://api.symbl.ai/v1/process/audio
#
Example API callThe sample request accepts just the raw audio file from the data with the MIME typeset in the Content-Type Header. The audio file should only have Mono Channel.
- cURL
- Javascript
#
Request Headersinfo
Content-Type: This field is optional.
If you're not sure about audio format, you can omit it since the API will automatically detect the content type. But when it's mentioned, audio format is validated.
Header Name | Required | Value |
---|---|---|
x-api-key | Yes | your_auth_token |
Content-Length | Yes | This should correctly indicate the length of the request body in bytes. |
Content-Type | No | This is OPTIONAL field which describes the format and codec of the provided audio data. Accepted values are audio/wav , audio/mpeg , audio/mp3 and audio/wave only. If your audio is in formats other than don't use this field. |
#
Query ParamsParameters | Required | Description |
---|---|---|
name | No | Your meeting name. Default name set to conversationId . |
webhookUrl | No | Webhook url on which job updates to be sent. This should be post API. |
customVocabulary | No | Contains a list of words and phrases that provide hints to the speech recognition task. |
entities | No | Input custom entities which can be detected in your conversation using Entities' API. For example, check the sample code on right. |
detectPhrases | No | Accepted values are true & false . It shows Actionable Phrases in each sentence of conversation. These sentences can be found in the Conversation's Messages API. |
enableSeparateRecognitionPerChannel | No | Enables Speaker Separated Channel audio processing. Accepts true or false . |
channelMetadata | No | This object parameter contains two variables speaker and channel to specific which speaker corresponds to which channel. This object only works when enableSeparateRecognitionPerChannel query param is set to true . |
languageCode | No | We accept different languages. Please check language Code as per your requirement. |
#
Webhook PayloadWebhookUrl will be used to send the status of job created for uploaded audio. Every time the status of the job changes it will be notified on the WebhookUrl
Field | Description |
---|---|
jobId | ID to be used with Job API |
status | Current status of the job. (Valid statuses - [ scheduled, in_progress, completed, failed ]) |
#
channelMetadata ObjectchannelMetadata
object has following members:
Field | Description |
---|---|
channel | This denotes the channel number in the audio file. Each channel will contain independent speaker's voice data. |
speaker | This is the wrapper object which defines the speaker for this channel. |
speaker
has the following members:
Field | Description |
---|---|
name | Name of the speaker. |
email | Email address of the speaker. |
caution
Billing for a speaker separated channel audio file happens according to the number of channels present in the audio files. The duration for billing will be calculated according to the below formula:
totalDuration = duration_of_the_audio_file * total_number_of_channels
So if you send a 120-second file with 3 speaker separated channels, the total duration for billing would be 360 seconds or 6 minutes.
#
Response#
Response ObjectField | Description |
---|---|
conversationId | ID to be used with Conversation API. |
jobId | ID to be used with Job API. |
#
Response on reaching limitField | Description |
---|---|
Payload | { "message" : "This API has a limit of maximum of 5 number of concurrent jobs per account. If you are looking to scale, and need more concurrent jobs than this limit, please contact us at support@symbl.ai" } |
Header | { "statusCode" : 429 } |