음성 설정 편집 | ElevenLabs Documentation

특정 음성의 설정을 편집합니다. “similarity_boost”는 웹 앱의 “Clarity + Similarity Enhancement”에 해당하며, “stability”는 웹 앱의 “Stability” 슬라이더에 해당합니다.

경로 매개변수

voice_idstring필수

사용할 음성의 ID입니다. 음성 가져오기 엔드포인트를 사용하여 사용 가능한 모든 음성을 나열할 수 있습니다.

요청

This endpoint expects an object.

stabilitydouble or null선택 사항0-1기본값 0.5

음성의 안정성과 각 생성 간 무작위성을 결정합니다. 값이 낮을수록 음성의 감정 표현 범위가 넓어집니다. 값이 높을수록 감정 표현이 제한된 단조로운 음성이 될 수 있습니다.

use_speaker_boostboolean or null선택 사항기본값 true

이 설정은 원래 화자와의 유사도를 높입니다. 이 설정을 사용하면 계산 부하가 약간 증가하며, 그에 따라 지연 시간도 늘어납니다.

similarity_boostdouble or null선택 사항0-1기본값 0.75

AI가 원본 음성을 복제할 때 얼마나 가깝게 따를지 결정합니다.

styledouble or null선택 사항기본값 0

음성 스타일의 과장 정도를 결정합니다. 이 설정은 원래 화자의 스타일을 강화합니다. 추가 컴퓨팅 리소스를 사용하며, 0 이외의 값으로 설정하면 지연 시간이 늘어날 수 있습니다.

speeddouble or null선택 사항기본값 1

음성 속도를 조정합니다. 기본 속도는 1.0이며, 1.0보다 작은 값은 음성을 느리게 하고 1.0보다 큰 값은 빠르게 합니다.

clone_strengthdouble or null선택 사항0-1

음성이 프로페셔널 음성 복제 샘플과 일치하는 정도를 0(낮음)에서 1(높음) 사이로 조절합니다. 대부분의 사용 사례에서는 0을 권장합니다. 기본 설정에서 문제가 발생한 경우에만 이 값을 높이세요. 선택한 v4 모델에 맞게 Finetune된 프로페셔널 음성 복제에만 적용됩니다.

응답

성공 응답

statusstring

음성 설정 편집 요청의 상태입니다. 요청에 성공하면 상태는 ‘ok’가 됩니다. 그렇지 않으면 상태 코드 500의 오류 메시지가 반환됩니다.

오류

422

Unprocessable Entity Error

경로 매개변수

헤더

요청

응답

오류