커스텀 보이스

커스텀 보이스 상세 정보 조회

SDK

수동 HTTP 호출보다 안전하고 빠른 통합을 위해 SDK를 사용하세요.

인증된 계정이 소유한 삭제되지 않은 커스텀 보이스 한 개를 조회합니다. 프리미엄 클로닝을 시작한 뒤 status가 completed 또는 failed가 될 때까지 이 API를 호출하세요.

GET/v1/custom-voices/{voice_id}

cURL

curl --request GET \
  --url https://api.typecast.ai/v1/custom-voices/uc_6700000000000000000000bb \
  --header 'X-API-KEY: <api-key>'

{
  "name": "브랜드 보이스",
  "error": null,
  "model": "ssfm-v30",
  "source": "professional",
  "status": "training",
  "voice_id": "uc_6700000000000000000000bb",
  "created_at": "2026-08-26T04:20:00Z"
}

인증

X-API-KEYstringheader필수

인증을 위한 API 키입니다. Typecast API 콘솔에서 API 키를 발급받을 수 있습니다.

경로 매개변수

voice_idstringrequired

조회할 커스텀 보이스의 고유 식별자입니다.

응답

200커스텀 보이스 상세 정보를 조회했습니다.application/json

namestring

보이스 이름입니다.

errorstring

status가 failed일 때의 실패 사유입니다.

modelstring

TTS 모델 버전입니다.

sourcestring

생성 방식(instant 또는 professional)입니다.

statuspending | training | completed | failed

현재 생성 또는 학습 상태입니다.

pendingtrainingcompletedfailed

voice_idstring

uc_로 시작하는 커스텀 보이스 고유 식별자입니다.

created_atstring

UTC 기준 생성 시각입니다.

cURL

curl --request GET \
  --url https://api.typecast.ai/v1/custom-voices/uc_6700000000000000000000bb \
  --header 'X-API-KEY: <api-key>'

{
  "name": "브랜드 보이스",
  "error": null,
  "model": "ssfm-v30",
  "source": "professional",
  "status": "training",
  "voice_id": "uc_6700000000000000000000bb",
  "created_at": "2026-08-26T04:20:00Z"
}