Search Voices

Search available voices by name, category, gender, accent, age, use case, or provider.

GET /v1/api/voices/search

Search Voices

cURL

curl --request GET \
  --url https://api.trillet.ai/v1/api/voices/search \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'

[
  {
    "_id": "665a1b2c3d4e5f6a7b8c9d0e",
    "name": "Wildflower",
    "voiceId": "mistv2_Wildflower",
    "provider": "rime",
    "gender": "female",
    "accent": "american",
    "description": "Alt Female, Smart",
    "previewUrl": "https://example.com/preview.mp3"
  },
  {
    "_id": "665a1b2c3d4e5f6a7b8c9d0f",
    "name": "Brook",
    "voiceId": "mistv2_Brook",
    "provider": "rime",
    "gender": "male",
    "accent": "american",
    "description": "Male, Friendly"
  }
]

Headers

x-api-key · string · required

API key used for authenticating requests to the API.

x-workspace-id · string · required

Workspace identifier for the API.

Query Parameters

name · string

Search voices by name.

category · string

Filter by voice category.

gender · string

Filter by gender (e.g., “male”, “female”).

accent · string

Filter by accent (e.g., “american”, “british”, “australian”).

age · string

Filter by age range (e.g., “young”, “middle_aged”, “old”).

useCase · string

Filter by use case (e.g., “conversational”, “narration”).

provider · string

Filter by provider (e.g., “rime”, “elevenlabs”, “hume”, “cartesia”).

Response Fields

voices · array

Array of matching voice objects.

_id · string

Unique identifier for the voice.

name · string

Display name of the voice.

voiceId · string

Voice ID used in TTS configuration.

provider · string

TTS provider for this voice.

gender · string

Gender of the voice.

accent · string

Accent of the voice.

description · string

Description of the voice characteristics.

previewUrl · string

URL to a voice preview audio sample.

[
  {
    "_id": "665a1b2c3d4e5f6a7b8c9d0e",
    "name": "Wildflower",
    "voiceId": "mistv2_Wildflower",
    "provider": "rime",
    "gender": "female",
    "accent": "american",
    "description": "Alt Female, Smart",
    "previewUrl": "https://example.com/preview.mp3"
  },
  {
    "_id": "665a1b2c3d4e5f6a7b8c9d0f",
    "name": "Brook",
    "voiceId": "mistv2_Brook",
    "provider": "rime",
    "gender": "male",
    "accent": "american",
    "description": "Male, Friendly"
  }
]