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: <x-sup-api-key>'
{
  "items": [
    {
      "voice_id": "<string>",
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "total": 25,
  "nextPageToken": "10"
}
条件に応じてボイスを検索できるAPIです。 自分のアカウントで利用可能な顧客登録ボイスを、名前や説明などのさまざまな条件でフィルタリングできます。

​
主なパラメーター

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

Headers

​
x-sup-api-key
string
required

API key for the service

Query Parameters

​
page_size
number

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

​
name
string

Search across name. Space separated.

​
description
string

Search across description. Space separated.

​
next_page_token
string

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

Response

200
application/json

Paginated custom voices search response with next page token

The response is of type object.