Regions - KugelAudio

By default, SDKs use the canonical geo-routed endpoint. Existing API keys and SDK code continue to work without changes. Select the direct EU endpoint only when you need to pin traffic to Europe.

Endpoint Options

Selection	Endpoint	Behavior
Default	`api.kugelaudio.com`	Canonical geo-routed API
`eu`	`api.eu.kugelaudio.com`	Direct EU endpoint
`us` / `global`	`api.kugelaudio.com`	Supported compatibility hints; use the canonical endpoint

Choosing EU

Use the default endpoint for automatic geo-routing. Select EU only when you need to pin traffic to Europe.

How to Set Your Region

There are two ways to select the direct EU endpoint.

Option 1: Prefix Your API Key

Prepend 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=eu-ka_your_api_key_here

No code changes needed — the SDK detects the prefix and uses the EU endpoint.

Option 2: Set the Region in Code

All SDKs accept an explicit EU region parameter:

Python
JavaScript
Java
cURL

from kugelaudio import KugelAudio

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

client = await KugelAudio.create(api_key="ka_your_api_key", region="eu")

import { KugelAudio } from 'kugelaudio';

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

import com.kugelaudio.sdk.*;

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

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

Priority

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

region — explicit EU region parameter
API key prefix — eu-
Default — canonical geo-routed API (api.kugelaudio.com)

WebSocket Connections

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

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

FAQ

Do I need to change anything if I use the default endpoint?

If you want automatic geo-routing, no. If you need to pin traffic to Europe, set region="eu" or use the eu- API key prefix.

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 with the default and EU endpoints — just add or remove the eu- prefix or region="eu" parameter. No need to regenerate keys.

​Endpoint Options

​Choosing EU

​How to Set Your Region

​Option 1: Prefix Your API Key

​Option 2: Set the Region in Code

​Priority

​WebSocket Connections

​FAQ