Skip to main content
GET
/
v1
/
custom-voices
Gets custom (cloned) voices
curl --request GET \
  --url https://supertoneapi.com/v1/custom-voices \
  --header 'x-sup-api-key: <api-key>'
{
  "items": [
    {
      "voice_id": "voice_123456789",
      "name": "My Custom Voice",
      "description": "A warm and friendly voice for customer service"
    }
  ],
  "total": 25,
  "next_page_token": "10"
}

Documentation Index

Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns the custom voices owned by your account. This includes voice clones created in Supertone Play and clones created via Create cloned voice — both endpoints feed into the same list.

​
Endpoint

GET https://supertoneapi.com/v1/custom-voices

​
Query parameters

NameRequiredDescription
page_size—Items per page. Default 20, max 100.
next_page_token—Token from a previous response to fetch the next page.

​
Response

Returns an items array of custom voice objects plus an optional next_page_token.

​
Notes

  • Custom voices are account-scoped — you only see voices owned by the account whose API key is used.
  • Custom voices are callable through the same TTS endpoints as preset voices; just pass the custom voice_id.

​
See also

Docs: Custom voices

Create, manage, and use cloned voices.

Create cloned voice

Upload a sample to register a new clone.

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 custom voices response with next page token

​
items
object[]
required

List of custom voice items

​
total
number
required

Total number of available custom voices

Example:

25

​
next_page_token
string

Token for fetching the next page of results. A valid non-negative integer string (e.g., "10", "20"). Null if no more pages.

Example:

"10"