사용 가이드
ElevenLabs Sound Effects v3 API: 30초 음향 효과, 심리스 루프 및 v2 마이그레이션
가격, 파라미터, 요청 예시와 프롬프트 작성법을 한 편으로 정리
- 모델
- elevenlabs-sound-effects
이 페이지에서
Sound Effects v3가 할 수 있는 것
ElevenLabs Sound Effects v3는 HiAPI의 텍스트-음향 효과 생성 모델이며, 모델 ID는 elevenlabs/sound-effects-v3입니다. 원하는 소리를 동작, 장면, 분위기, 표현 방식 등으로 텍스트로 설명하면 모델이 그에 해당하는 음향 효과를 생성합니다. 길이는 0.5–30초로 설정할 수 있으며, 시작과 끝이 매끄럽게 이어지는 루프 음향 효과를 요청할 수도 있습니다.
호출할 때마다 MP3 오디오 1개가 생성됩니다. 이 글에서는 가격, 파라미터, 요청 예시, v2와의 차이, 프롬프트 작성법을 소개합니다. 본문의 수치는 작성 시점의 인터페이스 정의를 기준으로 합니다.
Sound Effects v3 API 가격
요청한 길이(duration_seconds)를 기준으로 과금되며, 초당 $0.0029입니다.
- 2초(기본 길이): $0.0058
- 5초: $0.0145
- 10초: $0.029
- 30초(최대): $0.087
루프(loop)를 켜거나 prompt_influence를 조정해도 추가 요금은 없습니다. 작업이 실패하면 전액 환불됩니다. v2의 단가도 $0.0029/초로, 두 세대의 가격은 동일합니다.
파라미터
필수 파라미터는 prompt와 duration_seconds뿐이며, 나머지는 모두 생략할 수 있습니다.
prompt: 필수, 1–450자, 생성할 소리를 설명합니다.duration_seconds: 필수, 0.5–30초, '자동 길이'는 없습니다.loop: 매끄럽게 반복 재생 가능한 음향 효과를 생성할지 여부, 기본값false.prompt_influence: 0–1, 기본값 0.3. 값이 높을수록 프롬프트의 문자적 설명에 더 가까워지고, 낮을수록 결과의 변화가 많아집니다.
요청 보내기
HiAPI의 음향 효과 생성은 비동기 작업입니다. 먼저 작업을 생성한 뒤 결과를 조회합니다. model은 최상위에 두고, 나머지 파라미터는 input 안에 넣습니다.
5초짜리 문 열리는 소리를 생성하는 예시:
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/sound-effects-v3",
"input": {
"prompt": "Heavy wooden door creaking open slowly in a quiet stone hallway, then a soft thud as it stops",
"duration_seconds": 5
}
}'
10초짜리 반복 재생 가능한 빗소리를 생성하는 예시:
{
"model": "elevenlabs/sound-effects-v3",
"input": {
"prompt": "Gentle rain on a tin roof with distant rolling thunder, calm night ambience, no music",
"duration_seconds": 10,
"loop": true
}
}
두 번째 요청의 비용은 10 × $0.0029 = $0.029입니다. 작업을 생성한 후 GET https://api.hiapi.ai/v1/tasks/{taskId}를 폴링하여 상태가 성공으로 바뀌면, 출력에서 오디오 주소를 다운로드합니다.
v3와 v2의 차이
두 세대의 파라미터 이름과 가격은 동일하며, HiAPI에서의 차이는 주로 세 가지입니다:
- 길이 상한: v3는 최대 30초, v2는 최대 22초입니다. 22–30초의 환경음이나 깔개 소리가 필요하다면 v3만 사용할 수 있습니다.
- 효과: ElevenLabs 공식 문서에 따르면, v2와 비교해 v3는 여러 지시가 포함된 프롬프트를 더 정확히 따르고, 음악이나 목소리가 포함된 프롬프트를 더 잘 처리하며, 청감이 더 자연스럽고, 풍경이나 휘파람 같은 고주파 소리를 생성할 때 클리핑이 덜 발생합니다. 공식 문서에서도 결과는 프롬프트에 따라 다르므로, 자신의 프롬프트로 두 세대를 모두 시험해 볼 것을 권장합니다.
- 향후 유지보수: ElevenLabs 공식에서 v2(
eleven_text_to_sound_v2)를 지원 중단으로 표시했으며, 2027년 3월 1일에 서비스 종료할 예정입니다. 새 프로젝트는 v3를 바로 사용하는 것이 좋습니다.
v2에서 v3로 마이그레이션하려면 model을 elevenlabs/sound-effects-v3로 변경하기만 하면 되고, 나머지 파라미터는 수정할 필요가 없습니다. 출시 전에는 업무에서 자주 쓰는 몇 가지 프롬프트로 두 세대의 결과를 비교해 보는 것이 좋습니다.
프롬프트 작성법
- 구체적인 동작, 장면, 분위기와 표현 방식을 작성하세요. 포괄적인 카테고리 하나만 쓰지 마세요. 예를 들어 '젖은 자갈을 밟는 발소리, 느린 걸음 속도'가 '발소리'보다 더 안정적인 결과를 냅니다.
- 순서를 설명할 수 있습니다. 예: 'Footsteps on gravel, then a metallic door opens'(먼저 자갈을 밟는 발소리, 이어서 금속 문이 열림).
- 음향 효과 업계 용어를 사용할 수 있습니다. 예: impact(충격), whoosh(휙 지나가는 소리), ambience(환경음), one-shot(단발 음향 효과), drone(지속 깔개 소리).
- 모델이 횟수를 엄격히 반복할 것이라고 기대하지 마세요. 공식 설명에 따르면 '트라이앵글 4번 치기' 같은 정확한 횟수 요구는 실행되지 않을 수 있습니다. 정확한 리듬이 필요하다면 한 번 생성한 후 직접 편집하고 이어 붙이세요.
- 필요에 따라
prompt_influence를 조정하세요: UI 음향 효과, 알림음처럼 안정적이고 일관된 소리가 필요하면 0.6 이상으로 올릴 수 있습니다. 다양한 스타일의 시안을 여러 개 원할 때는 기본값 0.3 또는 그 이하를 사용하세요.
현재 제한 사항
- 호출할 때마다 오디오 1개만 생성됩니다. 여러 후보가 필요하면 여러 작업을 병렬로 보내세요.
- 길이 범위는 0.5–30초이며, 반드시 명시적으로 전달해야 하고 자동 길이는 없습니다.
- 프롬프트는 최대 450자입니다.
- 비동기 작업만 지원하며, 동기 반환은 없습니다.
- 출력은 MP3이며, 현재 다른 형식을 선택할 수 없습니다.
적합한 사용 사례
v3는 대량으로 짧은 음향 효과를 빠르게 생산해야 하는 시나리오에 적합합니다. 예를 들어 게임과 앱의 인터페이스 알림음, 숏폼 영상과 광고의 전환 음향 효과, 영화나 예고편 초기 단계의 폴리 사운드 샘플, 오디오북과 라이브 방송의 반복 환경음 등입니다. 5초짜리 음향 효과가 $0.0145이므로, 먼저 여러 버전을 일괄 생성한 뒤 마음에 드는 것을 골라 후반 작업에 들어가면 소재를 찾고 수정하는 비용보다 낮습니다.