Transcript Status

After you’ve submitted a file for transcription, your transcript has one of the following statuses:

Status	Description
`processing`	The audio file is being processed.
`queued`	The audio file is waiting to be processed.
`completed`	The transcription has completed successfully.
`error`	An error occurred while processing the audio file.

Handling errors

If the transcription fails, the status of the transcript is error, and the transcript includes an error property explaining what went wrong.

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 )
12 
13 transcript = aai.Transcriber().transcribe(audio_file, config)
14 
15 if transcript.status == aai.TranscriptStatus.error:
16     print(f"Transcription failed: {transcript.error}")
17     exit(1)
18 
19 print(transcript.text)

A transcription may fail for various reasons:

Unsupported file format
Missing audio in file
Unreachable audio URL

If a transcription fails due to a server error, we recommend that you resubmit the file for transcription to allow another server to process the audio.

Why am I receiving a "400 Bad Request" error when making an API request?

A “400 Bad Request” error typically indicates that there’s a problem with the formatting or content of the API request. Double-check the syntax of your request and ensure that all required parameters are included as described in the API reference. If the issue persists, contact our support team for assistance.

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	)
12
13	transcript = aai.Transcriber().transcribe(audio_file, config)
14
15	if transcript.status == aai.TranscriptStatus.error:
16	print(f"Transcription failed: {transcript.error}")
17	exit(1)
18
19	print(transcript.text)