소개
들리는 소리와 장소, 순서를 설명하십시오. ElevenLabs Sound Effects V3가 요청한 길이의 오디오 클립 하나를 반환합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 오디오 |
| 발행사 | ElevenLabs |
| 출시일 | 2026년 10월 29일 |
| 모달리티 | 오디오 |
| 작업 | 텍스트에서 효과음 생성 |
| 필수 입력 | 소리, 환경, 사건 순서를 설명하는 비어 있지 않은 텍스트 프롬프트 |
| 요청 길이 | 0.5~30초, 기본값 5초 |
| 반복 설정 | 불리언, 기본적으로 꺼짐 |
| 프롬프트 영향도 | 0~1, 기본값 0.3 |
| 예제 클립 | 각각 반복을 끄고 켠 5초 MP3 파일 2개 |
| 과금 기준 | 요청 길이를 초 단위로 올림하여 최소 1초부터 청구하며 실패한 요청은 과금하지 않습니다 |
핵심 기능 및 하이라이트
반복 없이 구성한 항구 사운드
항구 요청은 조용한 부두에서 작은 파도 위로 들리는 갈매기 울음을 설명합니다. 기본 영향도 0.3과 반복 꺼짐 설정으로 5초 MP3가 반환되었습니다. 물가 장면과 함께 들어 보며 새소리와 물소리의 균형을 판단합니다.
표면을 명시한 빗소리
비 요청은 울림이 있는 표면을 짧게 설명하고 반복을 켰으며 5초 MP3를 반환했습니다. 지속되는 배경 질감에도 같은 방식을 적용하고 반복 연결 부분을 들어 보며 장면과 어울리는지 확인합니다.
설정을 파악하며 사운드를 수정합니다
길이, 반복, 프롬프트 준수 정도는 서로 다른 결정을 다룹니다. 설정을 비교할 때 설명은 유지하고 반환된 클립과 설정을 함께 저장하여 편집에 사용할 버전을 구분합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 소리, 환경, 사건의 순서를 설명합니다. 1자 이상 |
duration_seconds | 아니요 | 길이는 0.5초에서 30초이며 기본값은 5초입니다. 시작된 초마다 과금됩니다. |
loop | 아니요 | 부드럽게 반복되도록 만든 클립을 요청합니다. 기본으로 꺼져 있습니다. 기본값: |
prompt_influence | 아니요 | 0에서 1까지 지정합니다. 값이 높을수록 프롬프트를 충실히 따릅니다. |
요금
$0.0024 / 초
ElevenLabs Sound Effects V3는 요청한 길이의 시작된 초마다 과금되며 최소 1초가 적용됩니다. 실패한 요청은 과금되지 않습니다.
활용 사례
로케이션 편집을 위한 항구 환경음
물가 장면을 구상할 때 항구 프롬프트를 출발점으로 활용합니다. 갈매기 울음, 작은 파도, 부두를 한 설명에 담았습니다. 해당 요청은 반복을 끈 5초 MP3를 반환했습니다.
실내 장면 아래에 깔리는 빗소리
양철 지붕 예제는 날씨 소리에 구체적인 표면을 지정합니다. 해당 요청은 반복을 켠 5초 MP3를 반환했습니다. 반복 재생할 배경음을 준비할 때 지속되는 소리와 명시된 재질의 조합을 시도합니다.
제품 영상의 재질을 드러내는 소리
제품 영상에서는 걸쇠, 미닫이 서랍, 금속 패널의 동작과 재질을 설명합니다. 주변 공간과 뒤따르는 떨림이나 잔향을 포함해 장면 속 사물의 소리를 구체적으로 지시합니다.
게임 프로토타입의 사건 흐름
작업장 문이 열리고 수레가 바닥을 굴러가는 흐름을 설명한 뒤 두 사건을 담을 길이를 선택합니다. 이 엔드포인트는 순서가 있는 소리 설명을 받습니다. 생성한 소리를 사용하기 전에 게임플레이 타이밍과 비교합니다.
프롬프트 가이드 및 실전 팁
들리는 사건을 설명합니다
소리를 내는 대상, 관련 재질, 주변 공간을 명시합니다. 연속된 사건은 듣고 싶은 순서대로 설명합니다.
용도에 맞는 클립 길이를 선택합니다
0.5~30초로 설정하며 기본값은 5초입니다. 동작과 잔향에 필요한 시간을 확보하고 요청한 길이에 표시되는 요금을 확인합니다.
반복과 지시 준수 정도를 설정합니다
반복되는 환경음이나 질감에는 반복을 켭니다. 기본 영향도 0.3에서 시작하여 결과가 지시를 따르는 정도를 비교하면서 조절합니다.
사용할 장면에서 들어 봅니다
반환된 클립을 지시문 및 함께 사용할 장면과 비교합니다. 반복 재생할 때는 긴 편집물 전체에 배치하기 전에 끝과 시작이 연결되는 부분을 확인합니다.
글로 작성한 지시로 사운드를 만듭니다
들리는 사건을 설명하여 영상 편집, 게임 장면, 오디오 제작에 쓸 짧은 효과음으로 변환합니다. 음원을 명시하고 환경을 정한 뒤 시간에 따라 무엇이 일어나는지 설명합니다. 클립 길이를 0.5~30초에서 선택하고, 소리가 반복되어야 하면 반복을 요청하며, 프롬프트 영향도로 지시를 따르는 정도를 조절합니다.
ElevenLabs는 SFX V3가 여러 소리가 포함된 지시를 V2보다 충실하게 따른다고 설명합니다. 연속된 사건은 듣고 싶은 순서로 작성하고 마지막 소리의 잔향이 사라질 시간도 확보합니다.
요청 설정을 선택합니다
비어 있지 않은 프롬프트가 필요합니다. 길이, 반복, 영향도에는 기본값이 있으므로 지시문부터 작성하고 장면을 구체화하며 설정을 바꿀 수 있습니다.
| 매개변수 | 유형 | 허용값 | 기본값 | 용도 |
|---|---|---|---|---|
prompt | 문자열 | 비어 있지 않은 텍스트 | 필수 | 소리, 환경, 사건 순서를 설명합니다. |
duration_seconds | 숫자 | 0.5~30 | 5 | 요청하는 클립 길이를 초로 설정합니다. |
loop | 불리언 | true 또는 false | false | 매끄러운 반복을 위한 클립을 요청합니다. |
prompt_influence | 숫자 | 0~1 | 0.3 | 결과가 설명을 따르는 정도를 조절합니다. |
동작에 맞는 길이를 정합니다
걸쇠가 닫히는 소리와 지붕에 계속 내리는 비는 필요한 시간 배분이 다릅니다. 동작과 마무리에 충분한 시간을 주고 편집에서 확보한 길이에 결과가 맞는지 확인합니다. 짧은 효과음은 몇 가지 소리에 집중하고 장면 전체를 압축해 넣지 않도록 합니다. 길이의 기본값은 5초이며 0.5~30초로 설정합니다.
반복과 길이를 구분합니다
꾸준한 빗소리나 환기 장치의 웅웅거림처럼 반복할 질감에는 loop를 켭니다. 이 설정은 선택한 길이 안에서 반복 재생을 위한 클립을 요청합니다. 편집기에서 여러 번 반복해 들으며 끝에서 시작으로 넘어가는 부분과 거슬리는 음량 변화에 주의를 기울입니다. 시작과 끝이 뚜렷한 사운드를 만들 때는 반복을 끕니다.
지시문을 유지하며 준수 정도를 비교합니다
영향도 범위는 0~1이며 기본값은 0.3입니다. 값이 높을수록 프롬프트를 더 충실하게 따르도록 요청합니다. 이 설정을 탐색할 때는 설명, 길이, 반복 설정을 그대로 두어 요청한 변화에 집중해서 듣습니다. 선택한 설정은 클립과 함께 저장해 이후 수정에 활용합니다.
귀로 평가할 수 있는 지시를 작성합니다
강철 걸쇠가 딸깍 닫히거나, 수레가 콘크리트 위를 구르거나, 비가 양철 지붕을 두드리는 것처럼 음원과 동작부터 작성합니다. 의도한 음색에 영향을 주는 경우 환경도 덧붙입니다. 조용한 작업장의 기계음은 탁 트인 항구의 기계음과 다른 맥락을 갖습니다. 묘사하는 세부 사항은 청자가 들어야 할 소리와 연결합니다.
순서를 따라가기 쉽게 작성합니다
‘그다음’ 같은 말로 동작을 연결하고 흐름이 어떻게 끝나는지 설명합니다. 예를 들어 작업장 문이 열리고, 수레가 바닥을 굴러간 뒤 멈추는 흐름을 작성합니다. 반환된 클립과 대조할 구체적인 순서를 제공합니다. 사건이 빽빽하게 느껴지면 지시를 간소화하거나 지원 범위 안에서 길이를 늘립니다.
ElevenLabs는 정확한 반복 횟수가 반영되지 않을 수 있다고 설명합니다. 정확한 횟수가 필요한 사운드라면 반환된 소리를 듣고 편집 과정에서 배치를 조절합니다.
환경음의 원천을 분명히 합니다
반복되는 배경에는 지속적인 소리와 그 특성을 만드는 재질 또는 공간을 명시합니다. ‘양철 지붕에 꾸준히 내리는 비’는 하나의 날씨 질감과 표면에 집중합니다. 수리점에서 웅웅거리는 팬도 안정적인 음원을 지정하는 방식입니다. 설정에서 반복을 켠 뒤 사용할 장면 아래에서 반복되는 클립을 검토합니다.
항구와 비 예제를 들어 봅니다
2026년 11월 18일 요청은 5초 MP3 파일 두 개를 반환했습니다. 두 요청 모두 프롬프트 영향도 0.3을 사용했으며 지시별로 반복 설정을 달리했습니다.
부두의 갈매기와 파도
‘조용한 항구에서 갈매기가 울고 작은 파도가 부두에 부딪힌다’라는 지시는 반복을 끈 5초 MP3를 반환했습니다. 두 음원을 같은 환경에 배치하는 프롬프트입니다. 물가 사운드의 출발점으로 활용한 뒤 장면과 함께 들으며 새소리와 물소리를 편집에 어떻게 배치할지 판단합니다.
양철 지붕을 두드리는 비
‘양철 지붕에 꾸준히 내리는 비’라는 지시는 반복을 켠 5초 MP3를 반환했습니다. 짧은 문장으로 계속되는 사건과 표면을 명시합니다. 긴 배경음을 준비할 때 클립을 반복 재생하고 주변 오디오와 함께 연결 부분을 검토합니다.
요청 길이로 예산을 계산합니다
요청을 계획할 때 이 페이지에 표시된 요금을 참고합니다. 요청 길이를 초 단위로 올림하여 최소 1초부터 청구합니다. 효과음 생성에 실패한 요청은 청구 금액에 포함하지 않습니다. 제출 전에 길이를 선택하고 프롬프트 수정본을 비교할 때는 길이를 유지하여 각 후보가 편집의 같은 구간을 채우도록 합니다.
관련 오디오 계열을 살펴봅니다
폴리 중심 프로젝트에는 foley/v1, 다른 오디오 계열을 탐색할 때는 seed-audio/1.0, 음악 프로젝트에는 elevenlabs/music-v2.5를 검토합니다. 각 계열의 지원 입력과 예제가 작업에 맞는지 확인합니다. 이 엔드포인트에서는 글로 된 소리 설명을 준비하고 길이, 반복, 영향도로 요청을 구성합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "elevenlabs/sound-effects-v3/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.






