List Voices
Get a list of available voices.
Query Parameters
Filter by language code (e.g., en, de)
Filter by category: premade, cloned, generated
Include public voices in results
Maximum number of voices to return (max: 100)
Response
{
"data": [
{
"id": 123,
"name": "Emma",
"description": "Warm, friendly female voice",
"category": "premade",
"sex": "female",
"age": "middle_aged",
"supported_languages": ["en", "de"],
"sample_text": "Hello, I'm Emma. How can I help you today?",
"avatar_url": "https://cdn.kugelaudio.com/avatars/emma.png",
"sample_url": "https://cdn.kugelaudio.com/samples/emma.mp3",
"is_public": true,
"verified": true
}
],
"meta": {
"total": 50,
"limit": 50,
"offset": 0
}
}
Example
curl -X GET "https://api.kugelaudio.com/v1/voices?language=en&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"
Get Voice
Get details for a specific voice.
Path Parameters
Response
{
"data": {
"id": 123,
"name": "Emma",
"description": "Warm, friendly female voice with a slight British accent",
"category": "premade",
"sex": "female",
"age": "middle_aged",
"supported_languages": ["en", "de", "fr"],
"sample_text": "Hello, I'm Emma. How can I help you today?",
"avatar_url": "https://cdn.kugelaudio.com/avatars/emma.png",
"sample_url": "https://cdn.kugelaudio.com/samples/emma.mp3",
"is_public": true,
"verified": true,
"created_at": "2024-01-15T10:30:00Z",
"settings": {
"default_cfg_scale": 2.0,
"recommended_cfg_range": [1.5, 3.0]
}
}
}
Example
curl -X GET "https://api.kugelaudio.com/v1/voices/123" \
-H "Authorization: Bearer YOUR_API_KEY"
Voice Object
Fields
| Field | Type | Description |
|---|
id | integer | Unique voice ID |
name | string | Voice name |
description | string | Voice description |
category | string | premade, cloned, or generated |
sex | string | male, female, or neutral |
age | string | young, middle_aged, or old |
supported_languages | array | ISO 639-1 language codes |
sample_text | string | Sample text for previewing |
avatar_url | string | URL to avatar image |
sample_url | string | URL to sample audio |
is_public | boolean | Whether voice is publicly available |
verified | boolean | Whether voice is verified |
Categories
| Category | Description |
|---|
premade | Built-in voices provided by KugelAudio |
cloned | Voices created from audio samples |
generated | AI-generated synthetic voices |
Supported Languages
Common language codes:
| Code | Language |
|---|
en | English |
de | German |
fr | French |
es | Spanish |
it | Italian |
pt | Portuguese |
nl | Dutch |
pl | Polish |
ja | Japanese |
zh | Chinese |
ko | Korean |
Error Responses
Voice Not Found
{
"error": {
"code": "not_found",
"message": "Voice not found",
"details": {
"voice_id": 999
}
}
}
Access Denied
{
"error": {
"code": "forbidden",
"message": "You do not have access to this voice",
"details": {
"voice_id": 123,
"reason": "private_voice"
}
}
}
