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 ensuring your audio data stays within a given data residency zone such as EU or US.

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

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). Your audio and transcription data will remain within the US.
Need EU data residency? Use the EU endpoint (sync.eu.assemblyai.com). Your audio and transcription data will remain within the EU.

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
JavaScript SDK
Python
JavaScript
cURL

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)

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);

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"])

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);

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'

Getting started

Features

API reference

Advanced

Integrations

Cloud endpoints & data residency

Data processing locations

Endpoints

Which endpoint should I use?

How to use it

​Data processing locations

​Endpoints

​Which endpoint should I use?

​How to use it

Data processing locations

Endpoints

Which endpoint should I use?

How to use it