agent-configuration

Get All Voices With Previews

Get all available voices from all TTS providers with preview URLs stored in MinIO.

This endpoint:

Fetches all voices from provider APIs (when configured)
Generates preview audio for all voices (pre-generated at startup)
Stores all previews in MinIO object storage
Returns MinIO URLs for all previews

Comprehensive Filtering:

Provider: Filter by TTS provider
Gender: male, female, neutral
Language: Single language code (e.g., ‘en’, ‘ta’, ‘hi’)
Languages: Multiple languages (comma-separated, e.g., ‘en,es,fr’)
Accent: american, british, spanish, french, german, indian, etc.
Age: young, middle_aged, old
Tone: warm, professional, friendly, authoritative, energetic, etc.
Use Case: voice_agents, customer_service, narration, marketing, etc.
Recommended: Filter for recommended voices only
Multilingual: Filter for multilingual voices only
Region: africa, asia, europe, middle_east, oceania, global
Primary Language: Filter by voice’s primary language

All previews are stored in MinIO and pre-generated at startup for fast access.

GET

/

config

/

voices

Get All Voices With Previews

curl --request GET \
  --url https://api.example.com/config/voices \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

provider

string | null

Filter by provider: elevenlabs, openai, cartesia, deepgram

gender

string | null

Filter by gender: male, female, neutral

language

string | null

Filter by language code (e.g., 'en', 'es', 'fr', 'ta', 'hi')

languages

string | null

Filter by multiple languages (comma-separated, e.g., 'en,es,fr')

accent

string | null

Filter by accent: american, british, australian, spanish, french, german, indian, etc.

age

string | null

Filter by age: young, middle_aged, old

tone

string | null

Filter by tone: warm, professional, friendly, authoritative, energetic, etc.

use_case

string | null

Filter by use case: voice_agents, customer_service, narration, marketing, etc.

recommended

boolean | null

Filter for recommended voices only

multilingual

boolean | null

Filter for multilingual voices only

region

string | null

Filter by region: africa, asia, europe, middle_east, oceania, global

primary_language

string | null

Filter by primary language of the voice

Response

Successful Response

Get Voice Filter MetadataGet available filter options and metadata for voice selection. **Frontend Usage:** Use this endpoint to: 1. Build filter UI components (dropdowns, checkboxes, etc.) 2. Know which filters are available per provider 3. Understand filter types and their options **Returns:** - All available filter options - Filter options per provider - Filter descriptions and types - Example filter combinations

Get All Voices With Previews

curl --request GET \
  --url https://api.example.com/config/voices \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}