Skip to navigation

녹음으로 음성 복제

View as Markdown

사용 권리를 확인한 짧은 음성 파일을 복제하고 Agent의 voice로 사용할 ID를 반환합니다. 원본 오디오는 요청 메모리에서 공급자로 전달한 뒤 즉시 지우며 한국AI통신 저장소에 보관하지 않습니다. 이 API로 만든 음성에는 미리듣기 샘플이 없습니다(콘솔에서 등록한 음성만 생성합니다). 계정당 시간당 약 10회로 제한됩니다. ElevenLabs 엔진은 계정당 5개까지 등록할 수 있습니다(복제 실패한 음성은 세지 않습니다).

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects a multipart form containing a file.
namestringRequired1-60 characters
descriptionstringOptional<=200 characters
providerstringOptional

복제 엔진. cartesia(기본) 또는 elevenlabs. 만든 음성은 같은 엔진의 TTS에서만 쓸 수 있습니다.

consentstringRequired

업로더가 이 목소리를 사용할 권리가 있음을 확인해야 합니다. true 또는 on.

clipfileRequired

최대 10MB의 wav, mp3, flac, ogg, webm 또는 m4a 음성 파일

Response

복제 완료

idstring

한국AI통신 복제 음성 리소스 ID

namestring
statusenum
Allowed values:
descriptionstring or nullOptional
providerenumOptional

복제 엔진. voice는 이 엔진의 configuration.tts.provider에서만 쓸 수 있습니다

Allowed values:
voicestringOptional

ready 상태에서 Agent voice 설정에 사용할 ID

consentAtdatetime or nullOptional
dateCreateddatetimeOptional

Errors

400
Bad Request Error
401
Unauthorized Error
409
Conflict Error
413
Content Too Large Error
429
Too Many Requests Error
502
Bad Gateway Error