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.

Endpoints

Endpoint	URL	Region
Global (default)	`https://sync.assemblyai.com/transcribe`	Nearest region
US data residency	`https://sync.us.assemblyai.com/transcribe`	us-west-2, us-east-1
EU data residency	`https://sync.eu.assemblyai.com/transcribe`	eu-north-1

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.

Python
JavaScript
cURL

Global (default)

import requests

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

response = requests.post(
    "https://sync.assemblyai.com/transcribe",
    headers={
        "Authorization": "<YOUR_API_KEY>",
        "X-AAI-Model": "u3-sync-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/transcribe",
    headers={
        "Authorization": "<YOUR_API_KEY>",
        "X-AAI-Model": "u3-sync-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/transcribe",
    headers={
        "Authorization": "<YOUR_API_KEY>",
        "X-AAI-Model": "u3-sync-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/transcribe", {
  method: "POST",
  headers: {
    Authorization: "<YOUR_API_KEY>",
    "X-AAI-Model": "u3-sync-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/transcribe", {
  method: "POST",
  headers: {
    Authorization: "<YOUR_API_KEY>",
    "X-AAI-Model": "u3-sync-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/transcribe", {
  method: "POST",
  headers: {
    Authorization: "<YOUR_API_KEY>",
    "X-AAI-Model": "u3-sync-pro",
  },
  body: form,
});

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

Global (default)

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

US data residency

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

EU data residency

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

​Endpoints

​Which endpoint should I use?

​How to use it

Endpoints

Which endpoint should I use?

How to use it