KugelAudio currently exposes Kugel 3 as the canonical production TTS model for new integrations.
New here? Use kugel-3. It supports voice cloning, streaming, multilingual generation, IPA, timestamps, and break tags.
Current model
| Model ID | Name | Best for |
|---|
kugel-3 | Kugel 3 | Voice agents, narration, brand voices, streaming, and multilingual TTS |
Legacy model IDs
Older integrations may still send previous model IDs. These IDs remain accepted for backwards compatibility, but new integrations should use kugel-3.
Legacy model_id | Status |
|---|
kugel-2.5 | Accepted for backwards compatibility |
kugel-2-turbo | Accepted for backwards compatibility |
kugel-2 | Accepted for backwards compatibility |
kugel-1 | Accepted for backwards compatibility |
kugel-1-turbo | Accepted for backwards compatibility |
Legacy requests may route through the current production model, but billing and Dashboard usage keep the requested model_id visible for auditability. Use kugel-3 in new integrations for the clearest reporting.
Example
audio = client.tts.generate(
text='Welcome to KugelAudio. <break time="400ms"/> How can I help you today?',
model_id="kugel-3",
cfg_scale=2.0,
)
const audio = await client.tts.generate({
text: 'Welcome to KugelAudio. <break time="400ms"/> How can I help you today?',
modelId: 'kugel-3',
cfgScale: 2.0,
});
curl -X POST https://api.kugelaudio.com/v1/tts/generate \
-H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Welcome to KugelAudio. <break time=\"400ms\"/> How can I help you today?",
"model_id": "kugel-3",
"cfg_scale": 2.0
}' \
--output output.pcm
Capabilities
| Capability | kugel-3 |
|---|
| Voice cloning (zero-shot) | Supported |
| IPA custom pronunciation | Supported |
| Built-in text normalization | Supported |
| Input text streaming | Supported |
| Output audio streaming | Supported |
| Word-level timestamps | Supported |
| Multilingual TTS | 39 languages, single multilingual model |
Break tags (break element) | Supported |
| Sample rate | 24 kHz native; 8 kHz, 16 kHz, 22.05 kHz, and 24 kHz output options |
| Max input length | 10,000 characters |
Listing models
GET /v1/models returns canonical current models only. Legacy IDs are accepted for backwards compatibility, but they are not included in this endpoint response.
models = client.models.list()
for model in models:
print(f"{model.id}: {model.name}")
const models = await client.models.list();
for (const model of models) {
console.log(`${model.id}: ${model.name}`);
}
curl https://api.kugelaudio.com/v1/models \
-H "Authorization: Bearer $KUGELAUDIO_API_KEY"
