sound-fx

sound-fx은(는) 무엇을 하나요?

텍스트 설명으로 모든 음향 효과를 생성하세요 — 발소리, 폭발음, 만화 같은 '뿅' 소리, 주변 빗소리 등 상상하는 모든 것을 만들 수 있습니다.

트리거

• 음향 효과 / sfx / foley
• 소리 생성 / 오디오 만들기
• 주변 소리 / 배경 잡음
• X는 어떤 소리야? / X의 소리를 만들어줘
• 音效 / 声音 / 音频效果

빠른 시작

# 동물
python3 skills/sound-fx/scripts/sfx.py "만족스럽게 가르랑거리는 고양이, 깊은 진동" -d 8
python3 skills/sound-fx/scripts/sfx.py "세 번 연속 재채기하는 개" -d 3
python3 skills/sound-fx/scripts/sfx.py "엄청 빠르게 밥 먹는 개, 우적우적 꿀꺽" -d 4

# 재미
python3 skills/sound-fx/scripts/sfx.py "만화 캐릭터가 엉덩이 맞는 소리, 과장된 찍찍 비명" -d 2
python3 skills/sound-fx/scripts/sfx.py "회의 도중 방귀 쿠션에 앉은 누군가" -d 2

# 주변 소리 (파일로 저장)
python3 skills/sound-fx/scripts/sfx.py "양철 지붕에 쏟아지는 폭우" -d 15 -o rain.wav
python3 skills/sound-fx/scripts/sfx.py "밤에 모닥불 타닥타닥, 귀뚜라미 소리" -d 15 -o campfire.wav

인자

인자	기본값	설명
prompt	필수	생성할 소리의 텍스트 설명
--duration / -d	자동	길이(초, 1–30). 생략하면 모델이 결정합니다.
--format / -f	wav	출력 형식: wav, mp3, flac
--output / -o	output.wav	생성된 오디오를 저장할 경로
--api-key	환경/설정	Noiz API 키 (저장된 키를 재정의)

설정

# API 키를 한 번 저장
python3 skills/sound-fx/scripts/sfx.py config --set-api-key YOUR_KEY

# 또는 환경 변수로 설정
export NOIZ_API_KEY=YOUR_KEY

developers.noiz.ai에서 API 키를 받으세요.

재미있는 예제 프롬프트

🐾 동물

프롬프트	권장 길이
"만족스럽게 가르랑거리는 고양이, 깊은 진동"	8초
"고양이가 공격적으로 쉿 소리 내고 울부짖음"	3초
"고양이가 유리잔을 테이블에서 떨어뜨림, 쾅"	2초
"세 번 연속 재채기하는 개"	3초
"초인종에 신나게 짖는 작은 개"	4초
"달을 향해 극적으로 울부짖는 개"	5초
"엄청 빠르게 밥 먹는 개, 우적우적 꿀꺽"	4초
"삐걱거리는 쳇바퀴를 미친 듯이 달리는 햄스터"	6초
"전화벨을 완벽하게 따라 하는 앵무새"	3초
"밤 연못에서 울어대는 개구리"	8초

😂 재미 & 표현

프롬프트	권장 길이
"만화 캐릭터가 엉덩이 맞는 소리, 과장된 찍찍 비명"	2초
"드라마틱한 실패 나팔 (왈 왈 왈 왈)"	3초
"회의 도중 방귀 쿠션에 앉은 누군가"	2초
"애니메이션 파워업 충전 소리"	5초
"바나나 껍질에 미끄러진 누군가, 만화 슬라이드와 쿵"	3초
"드라마틱한 다람쥐 응시 — 긴장감 넘치는 현"	3초
"고무 오리 삑삑이 세 번"	2초
"던전에서 울려 퍼지는 악당의 웃음"	5초
"군중이 믿기지 않는다는 듯 숨을 삼킴"	3초
"수동 공격적으로 들리는 알림 소리"	2초
"기계식 키보드를 격렬하게 두드리는 누군가"	5초

🌍 주변 & 분위기

프롬프트	권장 길이
"금속 지붕에 쏟아지는 폭우와 천둥"	15초
"북적이는 커피숍, 배경 대화와 에스프레소 머신"	15초
"오래된 전화 접속 모뎀이 인터넷에 연결되는 소리"	10초
"밤에 모닥불 타닥타닥, 귀뚜라미 소리"	15초
"바닷가에 잔잔히 부서지는 파도"	15초

🎮 액션 & SF

프롬프트	권장 길이
"우주선 레이저 블래스터"	2초
"몬스터 트럭 엔진 굉음"	5초
"칼집에서 뽑히는 검"	2초
"비디오 게임 레벨 업 팡파르"	3초

출력

성공하면 오디오 파일이 출력 경로에 저장되고 URL이 출력됩니다:

✓ Saved to output.wav (3.2s, 282 KB)
  URL: https://storage.googleapis.com/...

타사 통합

생성된 음향 효과를 Discord, Telegram, Feishu로 보내거나 ffmpeg로 비디오에 믹싱하는 방법은 ref_3rd_party.md를 참조하세요.

요구 사항

• Python 3.6+
• requests 패키지: pip install requests
• developers.noiz.ai의 Noiz API 키

보안 및 데이터 공개

• API 키: ~/.config/noiz/api_key (권한 0600) 또는 NOIZ_API_KEY 환경 변수로 저장됩니다.
• 네트워크: 텍스트 프롬프트는 생성을 위해 https://noiz.ai/v1/text-to-sound로 전송됩니다. 다른 데이터는 전송되지 않습니다.
• 출력: 생성된 오디오는 Noiz GCS URL에서 다운로드되어 로컬에 저장됩니다.