Regions

KugelAudio runs in multiple regions. By default, all traffic goes to the EU endpoint — existing API keys and SDK code continue to work without changes.

Available Regions

Region	Endpoint	Location
EU (default)	`api.kugelaudio.com`	Europe
US	`us-api.kugelaudio.com`	United States
Global	`global-api.kugelaudio.com`	Geo-routed to nearest region

Choosing a Region

Pick the region closest to your servers (or your users, for client-side apps). If your users are spread across continents, use Global to let geo-routing handle it.

How to Set Your Region

There are three ways to select a region, all supported by every SDK.

Option 1: Prefix Your API Key

Prepend us-, global-, or eu- to your API key. The prefix is stripped automatically before authentication — the server never sees it. This is the simplest approach, especially when your API key comes from an environment variable:

# .env
KUGELAUDIO_API_KEY=us-ka_your_api_key_here

No code changes needed — the SDK detects the prefix and routes accordingly.

Option 2: Set the Region in Code

All SDKs accept an explicit region parameter:

Python
JavaScript
Java
cURL

from kugelaudio import KugelAudio

client = KugelAudio(api_key="ka_your_api_key", region="us")

# Also works with the async factory
client = await KugelAudio.create(api_key="ka_your_api_key", region="global")

import { KugelAudio } from 'kugelaudio';

const client = new KugelAudio({
  apiKey: 'ka_your_api_key',
  region: 'us',
});

import com.kugelaudio.sdk.*;

KugelAudio client = new KugelAudio(
    KugelAudioOptions.builder("ka_your_api_key")
        .region(Region.US)
        .build()
);

# Point directly at the regional endpoint
curl -X POST https://us-api.kugelaudio.com/v1/tts/generate \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the US!", "model_id": "kugel-1-turbo"}'

Option 3: Set the API URL Directly

If you need full control over the endpoint — for example, when using a self-hosted deployment or a proxy — you can pass the URL directly. This overrides both the region parameter and any key prefix.

Python
JavaScript
Java
cURL

from kugelaudio import KugelAudio

client = KugelAudio(
    api_key="ka_your_api_key",
    api_url="https://us-api.kugelaudio.com",
)

import { KugelAudio } from 'kugelaudio';

const client = new KugelAudio({
  apiKey: 'ka_your_api_key',
  apiUrl: 'https://us-api.kugelaudio.com',
});

import com.kugelaudio.sdk.*;

KugelAudio client = new KugelAudio(
    KugelAudioOptions.builder("ka_your_api_key")
        .apiUrl("https://us-api.kugelaudio.com")
        .build()
);

curl -X POST https://us-api.kugelaudio.com/v1/tts/generate \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the US!", "model_id": "kugel-1-turbo"}'

Priority

When multiple region hints are present, the SDK resolves them in this order:

apiUrl — explicit URL always wins
region — explicit region parameter
API key prefix — us-, global-, or eu-
Default — EU (api.kugelaudio.com)

WebSocket Connections

Region selection applies to both REST and WebSocket endpoints. The SDK automatically uses the correct regional host for WebSocket connections:

wss://us-api.kugelaudio.com/ws/tts?api_key=YOUR_API_KEY

FAQ

Do I need to change anything if I'm happy with EU?

No. The default is EU and all existing API keys and code continue to work exactly as before.

Are voices and models the same across regions?

Yes. All regions serve the same models and have access to the same voice library, including your custom voices.

Can I switch regions without getting a new API key?

Yes. Your API key works in any region — just change the prefix or region parameter. No need to regenerate keys.

What does the Global region do?

Global (global-api.kugelaudio.com) uses geo-routing to direct your request to the nearest regional deployment, minimizing network latency automatically.

Getting Started

Speech Generation

Voices

Integrations

Deployment

SDK Reference

Available Regions

Choosing a Region

How to Set Your Region

Option 1: Prefix Your API Key

Option 2: Set the Region in Code

Option 3: Set the API URL Directly

Priority

WebSocket Connections

FAQ

Getting Started

Speech Generation

Voices

Integrations

Deployment

SDK Reference

Documentation Index

​Available Regions

​Choosing a Region

​How to Set Your Region

​Option 1: Prefix Your API Key

​Option 2: Set the Region in Code

​Option 3: Set the API URL Directly

​Priority

​WebSocket Connections

​FAQ

Available Regions

Choosing a Region

How to Set Your Region

Option 1: Prefix Your API Key

Option 2: Set the Region in Code

Option 3: Set the API URL Directly

Priority

WebSocket Connections

FAQ