List TTS voices | Talkif Docs

GET /api/v1/models/tts/voices

When any of gender, age, language, accent, or sort are present, routes to the ElevenLabs /v1/shared-voices endpoint (rich filtering, offset pagination). Otherwise routes to /v2/voices (simpler, cursor pagination).

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Query parameters

pageSizeintegerOptional

Page size (max 100, default 50)

nextPageTokenstringOptional

Pagination token for next page

searchstringOptional

Search term

voiceTypestringOptional

Voice type filter (v2 API)

categorystringOptional

Category filter

genderstringOptional

Gender filter (male, female, neutral) — shared-voices API

agestringOptional

Age group filter (young, middle_aged, old) — shared-voices API

languagestringOptional

Language filter (ISO code) — shared-voices API

accentstringOptional

Accent filter — shared-voices API

sortstringOptional

Sort order (trending, latest, most_users) — shared-voices API

pageintegerOptional

0-based page offset — shared-voices API

Response

ElevenLabs TTS voices

hasMoreboolean

Whether there are more results

totalCountinteger

Number of voices in this response (post-filter)

voiceslist of objects

List of voices

nextPageTokenstring or nullOptional

Token to fetch the next page

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error