Skip to main content
GET
Gets available voices
Returns the preset voice library available on your account. This includes the Supertone Play voice library as well as any voices Supertone has provided exclusively for Enterprise customers. For customer-cloned voices, use List custom voices instead.

Endpoint

Query parameters

Response

Returns an items array plus an optional next_page_token for pagination. Each item follows the voice object shape — voice_id, name, language, styles, models, samples, etc.

See also

Docs: Voices

Voice object shape and how to use voice IDs in TTS calls.

Search voices

Filter by language, style, gender, and more.

Authorizations

x-sup-api-key
string
header
required

Query Parameters

page_size
number

Number of items per page (default: 20, min: 10, max: 100)

next_page_token
string

Token for pagination (obtained from the previous page's response)

Response

Paginated available voices response with next page token

items
object[]
required

List of character items

total
number
required

Total number of available characters (might be approximate or removed in future)

Example:

150

next_page_token
string

Token for fetching the next page of results. Undefined if no more pages.

Example:

"some_opaque_token_string_representing_last_id"