List Voices
Retrieve all available voices. Results can be filtered by language, gender, and type. The response includes basic metadata for each voice.
GET
/api/voicesList all voices with optional filters.
Parameters
| Name | Type | Description |
|---|---|---|
language | string | Filter by language (e.g. "English", "Spanish"). |
gender | string | Filter by gender: male, female, neutral. |
type | string | Filter by type: base, custom, evolved. |
Response
{
"voices": [
{
"id": "voice_abc123",
"name": "Aurora",
"gender": "female",
"language": "English",
"type": "base",
"tags": ["warm", "professional"],
"use_count": 12500
}
]
}Search Voices
Full-text search across voice names, descriptions, and tags. Returns ranked results with relevance scores.
GET
/api/voices/searchSearch voices by keyword.
Parameters
| Name | Type | Description |
|---|---|---|
q* | string | Search query. |
limit | number | Max results to return.Default: 20 |
Response
{
"voices": [
{
"id": "voice_abc123",
"name": "Aurora",
"relevance": 0.95,
"tags": ["warm", "professional"]
}
],
"total": 3
}Voice Details
Retrieve detailed information about a specific voice, including its full metadata, embedding info, and creation history.
GET
/api/voices/{id}Get detailed voice information.
Response
{
"id": "voice_abc123",
"name": "Aurora",
"gender": "female",
"language": "English",
"type": "base",
"tags": ["warm", "professional"],
"use_count": 12500,
"created_at": "2026-01-15T00:00:00Z",
"preview_url": "/api/voices/voice_abc123/preview",
"embedding_format": "npy"
}Voice Statistics
Get usage statistics for a specific voice, including total synthesis count, average rating, and popular parameters.
GET
/api/voices/{id}/statsGet usage statistics for a voice.
Response
{
"voice_id": "voice_abc123",
"total_uses": 12500,
"uses_30d": 3200,
"avg_rating": 4.7,
"popular_speeds": [1.0, 1.1, 0.9],
"top_engines": ["kokoro", "f5tts"]
}