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"
}
이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.
계정이 소유한 커스텀 보이스를 반환합니다. Supertone Play에서 생성된 보이스 클론과 Create cloned voice로 생성된 클론이 모두 포함됩니다 — 두 경로 모두 동일한 목록에 반영됩니다.

​
엔드포인트

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

​
쿼리 파라미터

NameRequiredDescription
page_size—페이지당 항목 수입니다. 기본값 20, 최대 100.
next_page_token—다음 페이지를 가져오기 위한 이전 응답의 토큰입니다.

​
응답

커스텀 보이스 객체의 items 배열과 선택적 next_page_token을 반환합니다.

​
참고사항

  • 커스텀 보이스는 계정 범위입니다 — 사용된 API 키의 계정이 소유한 보이스만 조회됩니다.
  • 커스텀 보이스는 프리셋 보이스와 동일한 TTS 엔드포인트로 호출할 수 있습니다. 커스텀 voice_id를 그대로 전달해 주십시오.

​
함께 보기

Docs: Custom voices

클론드 보이스의 생성, 관리, 사용 방법입니다.

Create cloned voice

샘플을 업로드하여 새 클론을 등록합니다.

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"