API ReferenceModels & Voices
Voices & Favorites API
Reference for listing speaker voices, filtering categories, and toggling user favorites.
Discover speaker voice profiles, query taxonomy filters, and manage the user's personal favorites folder.
1. List Voices
Retrieve active speaker voices.
Endpoint
GET /api/v1/tts/voices
Request Headers
Authorization: Bearer sona_sk_your_api_key_hereResponse (200 OK)
{
"voices": [
{
"id": "db4e815d-00aa-43e6-99cf-0d9b4db9a07a",
"name": "Sarah",
"gender": "female",
"provider": "ElevenLabs",
"accent": "US American",
"language": "en",
"category": "professional",
"preview_url": "https://cdn.sonnalabs.app/audio/previews/sarah.mp3"
}
]
}2. Get Voices Filters
Retrieve voice taxonomy categories to build search filters in client UIs.
Endpoint
GET /api/v1/tts/filters
Response (200 OK)
{
"providers": ["ElevenLabs", "Google Cloud", "Gemini"],
"genders": ["male", "female"],
"languages": ["en", "id", "es", "fr", "pt", "ja"],
"accents": ["US American", "British", "Australian", "Indonesian"],
"categories": ["conversational", "professional", "narrator", "news"]
}3. List Favorites
Retrieve a list of voices that the authenticated user has marked as favorite.
Endpoint
GET /api/v1/tts/favorites
Response (200 OK)
{
"favorites": [
{
"id": "db4e815d-00aa-43e6-99cf-0d9b4db9a07a",
"name": "Sarah",
"gender": "female",
"provider": "ElevenLabs",
"accent": "US American",
"language": "en",
"category": "professional",
"preview_url": "https://cdn.sonnalabs.app/audio/previews/sarah.mp3"
}
]
}4. Toggle Favorite Voice
Add a voice to, or remove it from, the user's favorites collection.
Endpoint
POST /api/v1/tts/favorites/toggle
Request Body JSON
{
"voiceId": "db4e815d-00aa-43e6-99cf-0d9b4db9a07a"
}Response (200 OK)
{
"success": true,
"favorited": true
}If the voice was already favorited, the server removes it and returns "favorited": false.