ElevenAPIVoices설정

음성 설정 편집

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

경로 매개변수

voice_idstring필수

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

헤더

xi-api-keystring선택 사항

요청

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보다 큰 값은 빠르게 합니다.

응답

성공 응답

statusstring

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

오류

422
Unprocessable Entity Error