Skip to main content
GET
/
v1
/
custom-voices
/
search
Search custom (cloned) voices
curl --request GET \
  --url https://supertoneapi.com/v1/custom-voices/search \
  --header 'x-sup-api-key: <api-key>'
{
  "items": [
    {
      "voice_id": "<string>",
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "total": 25,
  "nextPageToken": "10"
}
自分のアカウントで利用可能な顧客登録ボイスを、名前や説明などのさまざまな条件でフィルタリングできます。

エンドポイント

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

主なパラメーター

パラメーター説明
nameボイス名で検索(部分一致)My cloned voice 1
description説明で検索(部分一致)kind and gentle など

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)

name
string

Search across name. Space separated.

description
string

Search across description. Space separated.

Response

Paginated custom voices search response with next page token

items
object[]
required

List of custom voice items

total
number
required

Total number of available custom voices

Example:

25

nextPageToken
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"