Regions

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

You can select the direct EU endpoint with an API-key prefix or an explicit region. You can also bypass region resolution by supplying an API URL directly.

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", "voice_id": 1071}'

Priority

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

Explicit API URL — api_url in Python, apiUrl in JavaScript, or apiUrl in Java
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?

Query /v1/models and /v1/voices on the endpoint you plan to use to confirm its current catalog and your custom-voice availability.

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.

Get started

Build a voice agent

Generate audio

Voices

Deploy

SDK Reference

API Reference

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

​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

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