음향 효과 생성 | ElevenLabs Documentation

세계 최고 수준의 음향 효과 모델을 사용해 텍스트를 비디오, 보이스오버 또는 비디오 게임용 음향 효과로 변환합니다.

쿼리 매개변수

output_formatenum선택 사항기본값 mp3_44100_128

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

enable_loggingboolean선택 사항기본값 true

enable_logging이 false로 설정되면 요청에 대해 보존 기간 0 모드가 사용됩니다. 보존 기간 0 모드는 엔터프라이즈 고객만 사용할 수 있습니다.

요청

This endpoint expects an object.

textstring필수

음향 효과로 변환할 텍스트입니다.

loopboolean선택 사항기본값 false

자연스럽게 반복 재생되는 음향 효과를 만들지 여부입니다.

duration_secondsdouble or null선택 사항

생성될 사운드의 길이(초)입니다. 최소 0.5초, 최대 30초여야 합니다. None으로 설정하면 프롬프트를 사용하여 최적의 길이를 추정합니다. 기본값은 None입니다.

prompt_influencedouble or null선택 사항기본값 0.3

프롬프트 영향력이 높을수록 생성 결과가 프롬프트를 더 밀접하게 따르지만, 생성 결과의 변동성은 줄어듭니다. 0과 1 사이의 값이어야 합니다. 기본값은 0.3입니다.

model_idenum선택 사항기본값 eleven_text_to_sound_v2

음향 생성에 사용할 모델 ID입니다.

허용된 값:

응답 헤더

character-coststring선택 사항

청구에 사용된 문자 수입니다.

응답

지정된 output_format으로 인코딩된 생성된 음향 효과 오디오입니다.

오류

422

Unprocessable Entity Error