Speech Threshold

Supported Languages, Regions, and Models

Speech threshold is supported for all languages, regions, and models.

To only transcribe files that contain at least a specified percentage of spoken audio, you can set the speech_threshold parameter. You can pass any value between 0 and 1.

If the percentage of speech in the audio file is below the provided threshold, the value of text is None and the response contains an error message:

1 Audio speech threshold 0.9461 is below the requested speech threshold value 1.0

A file must contain at least 30 seconds of audio for the amount of spoken audio to reliably be determined.

1 import assemblyai as aai
2 
3 aai.settings.api_key = "<YOUR_API_KEY>"
4 
5 # audio_file = "./local_file.mp3"
6 audio_file = "https://assembly.ai/wildfires.mp3"
7 
8 config = aai.TranscriptionConfig(
9     speech_models=["universal-3-pro", "universal-2"],
10     language_detection=True,
11     speech_threshold=0.5
12 )
13 
14 transcript = aai.Transcriber(config=config).transcribe(audio_file)
15 
16 if transcript.status == "error":
17   raise RuntimeError(f"Transcription failed: {transcript.error}")
18 
19 print(transcript.text)

1	import assemblyai as aai
2
3	aai.settings.api_key = "<YOUR_API_KEY>"
4
5	# audio_file = "./local_file.mp3"
6	audio_file = "https://assembly.ai/wildfires.mp3"
7
8	config = aai.TranscriptionConfig(
9	speech_models=["universal-3-pro", "universal-2"],
10	language_detection=True,
11	speech_threshold=0.5
12	)
13
14	transcript = aai.Transcriber(config=config).transcribe(audio_file)
15
16	if transcript.status == "error":
17	raise RuntimeError(f"Transcription failed: {transcript.error}")
18
19	print(transcript.text)