커스텀 보이스

커스텀 보이스 목록 조회

SDK

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

인증된 계정이 소유한 삭제되지 않은 커스텀 보이스를 조회합니다. 퀵 클로닝과 프리미엄 클로닝 보이스가 모두 포함되며 pending, training, completed, failed 상태가 표시될 수 있습니다.

합성 가능 여부는 status로 판단하세요. failed인 경우에만 error에 안전하게 가공된 실패 사유가 포함되며, 나머지 상태에서는 null입니다.

GET/v1/custom-voices

cURL

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

[
  {
    "name": "상품 내레이터",
    "error": null,
    "model": "ssfm-v30",
    "source": "instant",
    "status": "completed",
    "voice_id": "uc_6700000000000000000000aa",
    "created_at": "2026-08-26T04:15:00Z"
  },
  {
    "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 키를 발급받을 수 있습니다.

응답

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 \
  --header 'X-API-KEY: <api-key>'

[
  {
    "name": "상품 내레이터",
    "error": null,
    "model": "ssfm-v30",
    "source": "instant",
    "status": "completed",
    "voice_id": "uc_6700000000000000000000aa",
    "created_at": "2026-08-26T04:15:00Z"
  },
  {
    "name": "브랜드 보이스",
    "error": null,
    "model": "ssfm-v30",
    "source": "professional",
    "status": "training",
    "voice_id": "uc_6700000000000000000000bb",
    "created_at": "2026-08-26T04:20:00Z"
  }
]