Cloud endpoints & data residency

Choose the endpoint that best fits your application’s requirements — whether that’s using the default endpoint to route to the nearest data center, or processing your data within a specific geographic region.*

Note: File names may be processed by our subprocessors CrowdStrike and Datadog, which are located in the US. Do not include PII or PHI in file names if you require that information to remain in your selected data residency zone.

*AssemblyAI will store Account Data and Usage Data in the United States, per our Privacy Policy and the Data Privacy Framework. Audio, transcript, and prompt data will be stored in the endpoint region you select. Incident response and customer support may be conducted from locations where staff are employed, which may be in the US, EU, or elsewhere. If your audio, transcript, or prompt needs to be accessed for debugging, a member of our team located outside of your endpoint region may access that data and may use a US-based subprocessor to support the troubleshooting or customer support request.

Data processing locations

All Sync STT audio and transcription data is processed in AWS regions located in the United States and the European Union:

US

AWS region	Location
us-east-1	N. Virginia
us-east-2	Ohio
us-west-1	N. California
us-west-2	Oregon

EU

AWS region	Location
eu-central-1	Frankfurt
eu-north-1	Stockholm
eu-south-1	Milan
eu-south-2	Spain
eu-west-1	Ireland
eu-west-3	Paris

Which of these locations processes your data depends on the endpoint you call, as described below.

Endpoints

Endpoint	URL	Region
Global (default)	https://sync.assemblyai.com/v1/transcribe	Nearest region
US data residency	https://sync.us.assemblyai.com/v1/transcribe	US locations listed above
EU data residency	https://sync.eu.assemblyai.com/v1/transcribe	EU locations listed above

The global endpoint routes to the nearest available region, so your data may be processed in any of the US or EU locations listed above. If you need data to stay in one of those zones, call the US or EU endpoint explicitly rather than relying on the default.

Which endpoint should I use?

• Default? Use the Global endpoint (sync.assemblyai.com). It will route your request to the region with the fastest response time for you.
• Need US data residency? Use the US endpoint (sync.us.assemblyai.com).
• Need EU data residency? Use the EU endpoint (sync.eu.assemblyai.com).

How to use it

Replace the base URL in your request with the appropriate endpoint. The request format, headers, and parameters are identical for all endpoints. In the Python SDK the base URL comes from the sync_base_url setting; in the JavaScript SDK it’s the syncBaseUrl client option. Both default to the global endpoint.

Python SDK

Global (default)

from assemblyai.sync.v1 import SyncTranscriber

transcriber = SyncTranscriber(api_key="<YOUR_API_KEY>")
transcriber.warm()  # open the connection ahead of the request
result = transcriber.transcribe("sample.wav")
print(result.text)

US data residency

from assemblyai import Client, Settings
from assemblyai.sync.v1 import SyncTranscriber

client = Client(
    settings=Settings(
        api_key="<YOUR_API_KEY>",
        sync_base_url="https://sync.us.assemblyai.com",
    ),
)

transcriber = SyncTranscriber(client=client)
transcriber.warm()  # open the connection ahead of the request
result = transcriber.transcribe("sample.wav")
print(result.text)

EU data residency

from assemblyai import Client, Settings
from assemblyai.sync.v1 import SyncTranscriber

client = Client(
    settings=Settings(
        api_key="<YOUR_API_KEY>",
        sync_base_url="https://sync.eu.assemblyai.com",
    ),
)

transcriber = SyncTranscriber(client=client)
transcriber.warm()  # open the connection ahead of the request
result = transcriber.transcribe("sample.wav")
print(result.text)

JavaScript SDK

Global (default)

import { AssemblyAI } from "assemblyai";

const client = new AssemblyAI({ apiKey: process.env.ASSEMBLYAI_API_KEY });

await client.sync.warm(); // open the connection ahead of the request
const result = await client.sync.transcribe("sample.wav");
console.log(result.text);

US data residency

import { AssemblyAI } from "assemblyai";

const client = new AssemblyAI({
  apiKey: process.env.ASSEMBLYAI_API_KEY,
  syncBaseUrl: "https://sync.us.assemblyai.com",
});

await client.sync.warm(); // open the connection ahead of the request
const result = await client.sync.transcribe("sample.wav");
console.log(result.text);

EU data residency

import { AssemblyAI } from "assemblyai";

const client = new AssemblyAI({
  apiKey: process.env.ASSEMBLYAI_API_KEY,
  syncBaseUrl: "https://sync.eu.assemblyai.com",
});

await client.sync.warm(); // open the connection ahead of the request
const result = await client.sync.transcribe("sample.wav");
console.log(result.text);

Python

Global (default)

import requests

with open("sample.wav", "rb") as f:
    audio = f.read()

response = requests.post(
    "https://sync.assemblyai.com/v1/transcribe",
    headers={
        "Authorization": "<YOUR_API_KEY>",
        "X-AAI-Model": "universal-3-5-pro",
    },
    files={
        "audio": ("sample.wav", audio, "audio/wav"),
    },
    timeout=60,
)
response.raise_for_status()
result = response.json()
print(result["text"])

US data residency

import requests

with open("sample.wav", "rb") as f:
    audio = f.read()

response = requests.post(
    "https://sync.us.assemblyai.com/v1/transcribe",
    headers={
        "Authorization": "<YOUR_API_KEY>",
        "X-AAI-Model": "universal-3-5-pro",
    },
    files={
        "audio": ("sample.wav", audio, "audio/wav"),
    },
    timeout=60,
)
response.raise_for_status()
result = response.json()
print(result["text"])

EU data residency

import requests

with open("sample.wav", "rb") as f:
    audio = f.read()

response = requests.post(
    "https://sync.eu.assemblyai.com/v1/transcribe",
    headers={
        "Authorization": "<YOUR_API_KEY>",
        "X-AAI-Model": "universal-3-5-pro",
    },
    files={
        "audio": ("sample.wav", audio, "audio/wav"),
    },
    timeout=60,
)
response.raise_for_status()
result = response.json()
print(result["text"])

JavaScript

Global (default)

import { readFileSync } from "fs";

const audio = readFileSync("sample.wav");
const form = new FormData();
form.append("audio", new Blob([audio], { type: "audio/wav" }), "sample.wav");

const response = await fetch("https://sync.assemblyai.com/v1/transcribe", {
  method: "POST",
  headers: {
    Authorization: "<YOUR_API_KEY>",
    "X-AAI-Model": "universal-3-5-pro",
  },
  body: form,
});

const result = await response.json();
console.log(result.text);

US data residency

import { readFileSync } from "fs";

const audio = readFileSync("sample.wav");
const form = new FormData();
form.append("audio", new Blob([audio], { type: "audio/wav" }), "sample.wav");

const response = await fetch("https://sync.us.assemblyai.com/v1/transcribe", {
  method: "POST",
  headers: {
    Authorization: "<YOUR_API_KEY>",
    "X-AAI-Model": "universal-3-5-pro",
  },
  body: form,
});

const result = await response.json();
console.log(result.text);

EU data residency

import { readFileSync } from "fs";

const audio = readFileSync("sample.wav");
const form = new FormData();
form.append("audio", new Blob([audio], { type: "audio/wav" }), "sample.wav");

const response = await fetch("https://sync.eu.assemblyai.com/v1/transcribe", {
  method: "POST",
  headers: {
    Authorization: "<YOUR_API_KEY>",
    "X-AAI-Model": "universal-3-5-pro",
  },
  body: form,
});

const result = await response.json();
console.log(result.text);

cURL

Global (default)

curl -X POST https://sync.assemblyai.com/v1/transcribe \
  -H 'Authorization: <YOUR_API_KEY>' \
  -H 'X-AAI-Model: universal-3-5-pro' \
  -F 'audio=@sample.wav;type=audio/wav'

US data residency

curl -X POST https://sync.us.assemblyai.com/v1/transcribe \
  -H 'Authorization: <YOUR_API_KEY>' \
  -H 'X-AAI-Model: universal-3-5-pro' \
  -F 'audio=@sample.wav;type=audio/wav'

EU data residency

curl -X POST https://sync.eu.assemblyai.com/v1/transcribe \
  -H 'Authorization: <YOUR_API_KEY>' \
  -H 'X-AAI-Model: universal-3-5-pro' \
  -F 'audio=@sample.wav;type=audio/wav'