커스텀 보이스

퀵 클로닝 생성

SDK

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

SDK 가이드

WAV 또는 MP3 녹음 파일 한 개로 합성 가능한 커스텀 보이스를 생성합니다. 오디오, 표시 이름, 지원 TTS 모델을 multipart/form-data로 전송하세요.

오디오 요구 사항

WAV 또는 MP3 파일 1개
파일 크기: 25 MiB 이하
길이: 5초 이상 150초 이하

커스텀 보이스 슬롯 한 개를 사용하며 성공하면 생성이 완료된 보이스를 즉시 반환합니다. 지원 모델은 계정 및 출시 상태에 따라 달라질 수 있습니다.

POST/v1/custom-voices/instant-clone

cURL

curl --request POST \
  --url https://api.typecast.ai/v1/custom-voices/instant-clone \
  --header 'X-API-KEY: <api-key>' \
  --form 'file=@voice-sample.wav' \
  --form 'name=상품 내레이터' \
  --form 'model=ssfm-v30'

{
  "name": "상품 내레이터",
  "model": "ssfm-v30",
  "status": "completed",
  "voice_id": "uc_6700000000000000000000aa"
}

인증

X-API-KEYstringheader필수

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

본문

multipart/form-data

퀵 클로닝용 multipart 요청 본문입니다.

filestringrequired

25 MiB 이하이면서 길이가 5초 이상 150초 이하인 WAV 또는 MP3 음성 파일 1개입니다.

namestringrequired

최대 30자의 보이스 이름입니다.

modelssfm-v30 | ssfm-v21required

TTS 모델 버전입니다.

ssfm-v30ssfm-v21

응답

201퀵 클로닝 보이스를 생성했습니다.application/json

namestring

보이스 이름입니다.

modelstring

TTS 모델 버전입니다.

statuspending | training | completed | failed

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

pendingtrainingcompletedfailed

voice_idstring

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

cURL

curl --request POST \
  --url https://api.typecast.ai/v1/custom-voices/instant-clone \
  --header 'X-API-KEY: <api-key>' \
  --form 'file=@voice-sample.wav' \
  --form 'name=상품 내레이터' \
  --form 'model=ssfm-v30'

{
  "name": "상품 내레이터",
  "model": "ssfm-v30",
  "status": "completed",
  "voice_id": "uc_6700000000000000000000aa"
}