ElevenAPIVoice Design

음성 리믹스

프롬프트를 통해 기존 음성을 리믹스합니다. 이 메서드는 음성 미리보기 목록을 반환합니다. 각 미리보기에는 generated_voice_id와 base64로 인코딩된 mp3 오디오 형식의 음성 샘플이 포함됩니다. 음성을 생성하려면 선호하는 미리보기의 generated_voice_id를 /v1/text-to-voice 엔드포인트와 함께 사용하세요.

경로 매개변수

voice_idstring필수
Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.

헤더

xi-api-keystring선택 사항

쿼리 매개변수

output_formatenum선택 사항
생성된 오디오의 출력 형식입니다. codec_sample_rate_bitrate 형식으로 지정합니다. 예를 들어 샘플링 레이트가 22.05kHz이고 32kbps인 mp3는 mp3_22050_32로 표현됩니다. 비트레이트가 192kbps인 MP3를 사용하려면 크리에이터 이상의 요금제에 가입해야 합니다. 샘플링 레이트가 44.1kHz인 PCM 형식을 사용하려면 프로 이상의 요금제에 가입해야 합니다. μ-law 형식(mu-law로 표기되기도 하며 흔히 u-law로 근사 표기됨)은 Twilio 오디오 입력에 일반적으로 사용됩니다.

요청

This endpoint expects an object.
voice_descriptionstring필수5-1000 characters

음성에 적용할 변경 사항에 대한 설명입니다.

textstring or null선택 사항100-1000 characters

생성할 텍스트입니다. 텍스트 길이는 100자에서 1000자 사이여야 합니다.

auto_generate_textboolean선택 사항기본값 false

음성 설명에 적합한 텍스트를 자동으로 생성할지 여부입니다.

loudnessdouble선택 사항-1-1기본값 0.5

생성된 음성의 볼륨 레벨을 제어합니다. -1은 가장 작고, 1은 가장 크며, 0은 약 -24 LUFS에 해당합니다.

seedinteger or null선택 사항0-2147483647

음성 생성을 제어하는 난수입니다. 동일한 입력에 동일한 시드를 사용하면 동일한 음성이 생성됩니다.

guidance_scaledouble선택 사항0-100기본값 2

AI가 프롬프트를 얼마나 엄격하게 따를지 제어합니다. 값이 낮을수록 AI가 창의성을 발휘할 여지가 커지고, 값이 높을수록 프롬프트를 더 엄격하게 따릅니다. 값이 높으면 음성이 부자연스럽거나 로봇처럼 들릴 수 있습니다. Guidance Scale이 낮을 때는 더 길고 자세한 프롬프트를 사용하는 것이 좋습니다.

stream_previewsboolean선택 사항기본값 false

Determines whether the Text to Voice previews should be included in the response. If true, only the generated IDs will be returned which can then be streamed via the /v1/text-to-voice/:generated_voice_id/stream endpoint.

remixing_session_idstring or null선택 사항

리믹싱 세션 ID입니다.

remixing_session_iteration_idstring or null선택 사항

이러한 생성을 첨부할 리믹싱 세션 반복의 ID입니다. 제공하지 않으면 새 반복이 생성됩니다.

prompt_strengthdouble or null선택 사항0-1

음성 샘플 생성 시 프롬프트와 참조 오디오 간의 균형을 제어합니다. 0은 프롬프트 영향이 거의 없음을, 1은 참조 오디오 영향이 거의 없음을 의미합니다. eleven_ttv_v3 모델 사용 시에만 지원됩니다.

응답

성공 응답

previewslist of objects

생성된 음성의 미리보기입니다.

textstring

음성을 미리 듣는 데 사용되는 텍스트입니다.

오류

409
Conflict Error
422
Unprocessable Entity Error