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"