Sentiment Analysis

The Sentiment Analysis model detects the sentiment of each spoken sentence in the transcript text. Use Sentiment Analysis to get a detailed analysis of the positive, negative, or neutral sentiment conveyed in the audio, along with a confidence score for each result.

Quickstart

Enable Sentiment Analysis by setting sentiment_analysis to true in the transcription config.

1import assemblyai as aai
2
3aai.settings.api_key = "<YOUR_API_KEY>"
4
5# audio_file = "./local_file.mp3"
6audio_file = "https://assembly.ai/wildfires.mp3"
7
8config = aai.TranscriptionConfig(sentiment_analysis=True)
9
10transcript = aai.Transcriber().transcribe(audio_file, config)
11
12for sentiment_result in transcript.sentiment_analysis:
13    print(sentiment_result.text)
14    print(sentiment_result.sentiment)  # POSITIVE, NEUTRAL, or NEGATIVE
15    print(sentiment_result.confidence)
16    print(f"Timestamp: {sentiment_result.start} - {sentiment_result.end}")

Open In Colab

Example output

1Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US.
2SentimentType.negative
30.8181032538414001
4Timestamp: 250 - 6350
5...

Add speaker labels to sentiments

To add speaker labels to each sentiment analysis result, using Speaker Diarization, enable speaker_labels in the transcription config.

Each sentiment result will then have a speaker field that contains the speaker label.

1config = aai.TranscriptionConfig(
2  sentiment_analysis=True,
3  speaker_labels=True
4)
5
6# ...
7
8for sentiment_result in transcript.sentiment_analysis:
9  print(sentiment_result.speaker)

API reference

Request

$curl https://api.assemblyai.com/v2/transcript \
>--header "Authorization: <YOUR_API_KEY>" \
>--header "Content-Type: application/json" \
>--data '{
>  "audio_url": "YOUR_AUDIO_URL",
>  "sentiment_analysis": true
>}'
KeyTypeDescription
sentiment_analysisbooleanEnable Sentiment Analysis.

Response

KeyTypeDescription
sentiment_analysis_resultsarrayA temporal sequence of Sentiment Analysis results for the audio file, one element for each sentence in the file.
sentiment_analysis_results[i].textstringThe transcript of the i-th sentence.
sentiment_analysis_results[i].startnumberThe starting time, in milliseconds, of the i-th sentence.
sentiment_analysis_results[i].endnumberThe ending time, in milliseconds, of the i-th sentence.
sentiment_analysis_results[i].sentimentstringThe detected sentiment for the i-th sentence, one of POSITIVE, NEUTRAL, NEGATIVE.
sentiment_analysis_results[i].confidencenumberThe confidence score for the detected sentiment of the i-th sentence, from 0 to 1.
sentiment_analysis_results[i].speakerstring or nullThe speaker of the i-th sentence if Speaker Diarization is enabled, else null.

Frequently asked questions

The Sentiment Analysis model is based on the interpretation of the transcript and may not always accurately capture the intended sentiment of the speaker. It’s recommended to take into account the context of the transcript and to validate the sentiment analysis results with human judgment when possible.

The Content Moderation model can be used to identify and filter out sensitive or offensive content from the transcript.

It’s important to ensure that the audio being analyzed is relevant to your use case. Additionally, it’s recommended to take into account the context of the transcript and to evaluate the confidence score for each sentiment label.

The Sentiment Analysis model is designed to be fast and efficient, but processing times may vary depending on the size of the audio file and the complexity of the language used. If you experience longer processing times than expected, don’t hesitate to contact our support team.

Built with