Cloud Endpoints and Data Residency

Choose the endpoint that best fits your application’s requirements—whether that’s using the default US region or ensuring your audio data stays within the European Union.

Default Endpoint

The default endpoint (api.assemblyai.com) processes your pre-recorded audio transcription requests in the US region. If you don’t specify a base URL, this is the endpoint used for the request.

EU Data Residency

The EU endpoint (api.eu.assemblyai.com) guarantees your data never leaves the European Union. This is designed for organizations with strict data residency and governance requirements—your audio and transcription data will remain entirely within the EU.

Endpoints

Which endpoint should I use?

• No data residency requirements? Use the default endpoint. No configuration change is needed.
• Need EU data residency? Use the EU endpoint to ensure your audio and transcription data stays within the European Union.

How to use it

Update your base URL to your preferred endpoint. Select an endpoint tab below to see examples for each.

1
import assemblyai as aai
2
3
aai.settings.api_key = "<YOUR_API_KEY>"
4
5
# No base_url override needed — US is the default
6
# audio_file = "./local_file.mp3"
7
audio_file = "https://assembly.ai/wildfires.mp3"
8
9
config = aai.TranscriptionConfig(
10
    speech_models=["universal-3-pro", "universal-2"],
11
    language_detection=True,
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)