개발자를 위한 SFX v3 소개

오늘 Sound Effects API의 최신 음향 효과 모델인 SFX v3를 출시합니다. SFX v2보다 여러 지시가 포함된 프롬프트를 더 충실히 따르며, 보컬과 음악도 더 잘 처리합니다. 사용해 보려면 POST /v1/sound-generation 엔드포인트에서 model_id를 eleven_text_to_sound_v3로 설정하세요.

모델 ID

새 모델로 업데이트하려면 모델 ID만 변경하면 됩니다:

from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

audio = elevenlabs.text_to_sound_effects.convert(
    text="Football crowd cheering, hearing a ball drop, crowd booing",
    model_id="eleven_text_to_sound_v3",
)

모델은 프롬프트를 바탕으로 음향 효과의 길이를 결정합니다. 정확한 길이가 필요하다면 duration_seconds를 원하는 시간으로 설정하세요.

출력이 요청한 내용과 달라진다면 prompt_influence를 기본값인 0.3보다 높이세요. 값이 높을수록 프롬프트를 더 충실히 따르고 생성 결과 간 변동은 줄어듭니다. output_format 쿼리 파라미터로 mp3_44100_128 또는 pcm_48000과 같은 코덱과 샘플 레이트를 설정할 수 있습니다.

현재 루핑은 eleven_text_to_sound_v2에서만 작동하므로, 요청에 루핑이 필요하다면 loop: true와 함께 v2 모델을 사용하세요.

프롬프트 작성 방법

SFX v3는 여러 부분으로 구성된 음향 효과에 탁월합니다. 모델을 최대한 활용하려면 프롬프트의 순서가 중요합니다. 예를 들어 "자갈 위를 걷는 발소리, 이어서 금속 문이 열리는 소리"처럼 발생 순서대로 이벤트를 나열하세요. 하나의 소리에는 짧고 구체적인 프롬프트가 가장 효과적입니다.

표현 방식도 중요합니다. 한 테스터는 "프랑스어로 말다툼하는 커플"이 "프랑스어로 싸우는 커플"보다 훨씬 더 잘 작동한다는 것을 발견했습니다. 하나로 결정하기 전에 같은 이벤트를 여러 방식으로 표현해 보세요.

두 모델 모두 테스트하기

SFX v3는 점진적인 업데이트입니다. 징, 차임, 주전자 휘파람처럼 고주파 음에서 클리핑이 발생할 가능성이 더 낮고, 엔지니어링 팀에 따르면 전반적으로 더 자연스럽게 들립니다.

두 모델 모두 동일한 엔드포인트에서 실행되므로 A/B 테스트 비용이 적게 듭니다. 전환하기 전에 가장 자주 사용하는 프롬프트를 v2와 v3에서 모두 실행해 결과를 비교해 보세요.

SFX v3 사용해 보기

전체 파라미터 목록은 음향 효과 생성 API 레퍼런스에서 확인한 다음, 첫 v3 요청을 보내세요. 코드를 작성하기 전에 음향 효과를 들어 보고 싶다면 ElevenCreative의 Sound Effects 탭, Flows 및 Studio에서도 사용할 수 있습니다.