ElevenLabs
ElevenLabs Sound Effects
elevenlabs/sound-effects-v3
ElevenLabs의 텍스트-투-사운드 이펙트 시리즈로, 동작·장면·분위기를 자연어로 묘사하면 음향 효과를 생성할 수 있으며, 길이, 심리스 루프, 프롬프트 준수도를 설정할 수 있어 게임 음향 효과, 영상 프리비즈 폴리, 앰비언스 바탕 깔기에 적합합니다
elevenlabs/sound-effects-v3 사용해 보기
입력
작품 갤러리
모든 작품 보기출력
가격
elevenlabs/sound-effects-v3 per second
| 단가 | $0.0029 |
|---|
포지셔닝 소개
텍스트 설명을 바탕으로 음향 효과를 생성하는 오디오 모델로, 프롬프트를 통해 동작, 환경, 분위기와 표현 방식을 지정할 수 있습니다. 입력 방식은 필수인 사운드 설명과 길이이며, 추가로 무缝 루프 여부와 프롬프트 영향 정도를 선택할 수 있습니다. 게임 개발, 영상 후반 작업, 숏폼 영상 제작, 인터랙티브 제품 팀이 프로젝트에 바로 넣을 수 있는 짧은 음향 효과 소재를 빠르게 확보하는 데 적합합니다.
핵심 하이라이트
- 프롬프트 최대 450자——한 문장으로 동작, 장면, 분위기를 묘사할 수 있으며 상한은 450자로, 비교적 세밀한 사운드 디테일을 담을 만한 표현 공간이 충분합니다.
- 길이 0.5~30초 설정 가능——요청마다 필요한 초 수를 지정하며, 짧은 클릭음부터 30초 환경음까지 일반적인 소재 길이를 커버합니다.
- 무결점 루프 출력 지원——무결점 루프를 켜면 시작과 끝이 자연스럽게 이어지는 음향 효과를 생성하며, 지속 재생이 필요한 배경음이나 기계음에 적합합니다.
- 프롬프트 영향 정도 조절 가능——0에서 1 사이의 값으로 밀착도를 제어하며, 값이 낮으면 결과가 더 다양해지고 값이 높으면 설명에 더 가까워집니다.
능력 설명
텍스트 설명으로 음향 효과 생성: 동작, 장면, 분위기와 표현 방식에 대한 사운드 설명을 제출하면 모델이 해당 오디오를 출력합니다. 설명은 필수이며 공백 문자만 포함할 수 없고 최대 450자입니다.
음향 효과 길이 사용자 지정: 요청마다 0.5~30초의 길이를 반드시 지정해야 하며 자동 길이는 지원하지 않습니다. 짧은 음향 효과와 비교적 긴 분위기음 모두 동일한 파라미터 세트 안에서 처리됩니다.
무결점 루프 옵션: 무결점 루프를 켜면 연속 재생에 적합한 음향 효과를 생성하고, 끄면 일반 단일 음향 효과로 출력합니다.
프롬프트 밀착도 조절: 0에서 1 사이의 프롬프트 영향 파라미터로 결과의 다양성과 밀착도의 균형을 맞춥니다. 0은 더 자유롭고 1은 설명을 더 엄격히 따르며 기본값은 0.3입니다.
활용 장면
- 게임 팀의 인터랙션 피드백 음향 효과 제작——버튼 클릭, 스킬 발동 등 동작 설명을 입력하고 짧은 길이를 설정해 게임 이벤트에 바로 넣을 수 있는 오디오 소재를 얻습니다.
- 영상 후반 작업의 환경 분위기음 보충——장면과 분위기 설명으로 십여 초의 환경음을 생성해 편집 타임라인에 배경 깔개나 전환 음향 효과로 배치합니다.
- 숏폼 영상 제작자의 사운드 포인트 추가——화면 내용에 따라 전환, 알림 등 짧은 음향 효과를 1~2초 내로 묘사해 편집 소프트웨어의 효과음 트랙에 사용합니다.
- 인터랙티브 제품 디자인의 루프 배경음——무결점 루프를 켜고 길이를 지정해 연속 재생 가능한 기계음이나 분위기음을 생성하여 데모와 프로토타입의 사운드 피드백에 사용합니다.
제한 사항 및 선택 가이드
프롬프트는 최대 450자이며 초과 시 간소화해야 합니다. 요청마다 0.5~30초의 길이를 반드시 지정해야 하며 자동 길이는 지원하지 않습니다. 설명이 너무 짧거나 영향 파라미터가 변화 쪽으로 치우치면 결과가 예상과 다를 수 있어 여러 번 시도해 선택해야 합니다. 출력은 음향 효과 오디오이므로 완전한 음악 편곡이나 보컬 노래가 필요한 작업에는 적합하지 않습니다.
자주 묻는 질문
모든 질문 보기 →-
이 모델은 최대 얼마나 긴 음향 효과를 생성할 수 있나요?
현재 버전은 이전 세대와 지원하는 최대 길이가 다릅니다. elevenlabs/sound-effects-v3는 한 번 생성 시 0.5초에서 30초까지 설정할 수 있고, elevenlabs/sound-effects-v2는 0.5초에서 22초까지입니다. 두 버전 모두 duration_seconds를 명시적으로 전달해야 하며, 자동 길이는 지원하지 않습니다.
-
생성 결과를 제 설명에 더 가깝게 만들려면 어떻게 해야 하나요?
prompt_influence 값을 높이면 됩니다. 이 값은 프롬프트를 얼마나 따를지 제어합니다. 값의 범위는 0에서 1이며 기본값은 0.3입니다. 1에 가까울수록 설명 그대로 엄격하게 생성하고, 0에 가까울수록 느슨해져 변화가 많아지므로 예상치 못한 창의성이 필요한 상황에 적합합니다.
-
효과 좋은 음향 효과 프롬프트는 어떻게 작성하나요?
'동작, 환경, 분위기, 연기' 네 가지 요소에 따라 구성하고, 한 단락의 일관된 설명으로 작성하는 것을 권장합니다. 예를 들어 먼저 소리가 어떤 동작에서 발생하는지 쓰고, 다음으로 어떤 장면에서 일어나는지, 전체 분위기가 긴장감인지 조용한지 쓴 뒤, 마지막으로 음색이나 리듬 같은 연기 세부 사항을 보충합니다. 전체 단락은 450자 이내로 유지하세요. v3는 이러한 여러 지시가 포함된 프롬프트를 더 안정적으로 따르므로, 동의어를 쌓는 것보다 요소를 명확히 나누는 것이 더 효과적입니다.
-
루프 음향 효과는 어떻게 생성하나요?
loop을 true로 설정하면 이음새 없이 반복되는 음향 효과가 생성됩니다. 결과물에는 인지 가능한 시작점과 끝점이 포함되지 않아 앰비언트 사운드, 환경 텍스처, 장시간 배경 깔기에 적합합니다. 기본값은 false이며, 이 경우 일반적인 시작과 끝이 있는 음향 효과가 생성됩니다.
생성 작업 제출
https://api.hiapi.ai/v1/tasks 헤더
Authorizationstring필수계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기
Content-Typestring선택요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.
Idempotency-Keystring선택멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.
네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.
본문
modelstring필수현재 고정 값: elevenlabs/sound-effects-v3
routestring선택현재 고정 값: default
inputobject필수
elevenlabs/sound-effects-v3 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.
loopboolean선택기본값: false생성된 음향 효과를 끊김 없이 반복 재생할 수 있는지 여부를 제어합니다. 불리언 값이며 기본값은 false(반복 안 함)입니다.
promptstring필수minLength 1maxLength 450pattern \S필요한 음향 효과를 설명하는 텍스트로, 동작, 장면, 분위기 및 표현 방식을 포괄해야 하며 최대 450자까지 가능합니다.
duration_secondsnumber필수기본값: 2min 0.5max 30생성할 음향 효과의 길이로 단위는 초이며, 값 범위는 0.5~30이고 기본값은 2입니다. 자동 길이는 지원되지 않습니다.
prompt_influencenumber선택기본값: 0.3min 0max 1생성 결과가 프롬프트를 따르는 정도를 제어합니다. 값이 0이면 더 무작위하고 다양하며, 1이면 설명에 더 엄격하게 근접합니다. 기본값은 0.3입니다.
callbackobject선택
종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.
생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.
urlstring필수callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.
whenstring선택기본값: "final"현재는 final만 지원(success / fail 모두 알림).
finalstoragestring선택기본값: "temp"산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.
temppersistent요청 예시
# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
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": {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "elevenlabs/sound-effects-v3",
input: {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "elevenlabs/sound-effects-v3",
"input": {
"loop": False,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} 작업 상세 조회
https://api.hiapi.ai/v1/tasks/:id 응답 필드
taskIdstring필수태스크 ID. 접두사는 항상 tk-hiapi-.
modelstring필수확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.
routestring선택route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.
statusstring필수태스크 상태.
queued 대기 중, 아직 시작되지 않음.
handling 처리 중.
archiving 처리 완료, 산출물 준비 중.
success 종료: 완료. 산출물 사용 가능(output 반환).
fail 종료: 실패(error 반환).
제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.
creatednumber필수태스크 생성 시각(Unix 초).
completednumber필수종료 상태가 된 Unix 초. 비종료 상태에서는 0.
outputarray선택
status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).
Array [ object ]
배열 항목
urlstring필수산출물 URL. 바로 다운로드할 수 있습니다.
typestring필수현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.
expireAtnumber필수산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.
errorobject선택
status == fail일 때만 나타납니다.
codestring필수비즈니스 오류 코드.
messagestring필수오류 설명.
응답 예시
성공
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} 처리 중(비종료)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} 실패
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} 아티클
모든 아티클 보기 →관련 모델
모든 모델 보기 →동일 유형
-
Lyria 3.5 Google $0.090 /곡 -
Qwen Audio 3.0 TTS Alibaba $0.030 /1,000자 -
Lyria 3 Pro Google $0.140 /곡 -
ElevenLabs ElevenLabs $0.125 /1,000자 -
MiniMax Music 3 MiniMax $0.0026 /초 -
MiniMax Music 2.6 MiniMax $0.210 /곡 -
MiniMax Music 1.5 MiniMax $0.070 /곡 -
Mureka 9.5 Mureka $0.322 per request -
Mirelo SFX 2.0 Mirelo AI $0.021 /초


