Back to Details

sound-fx

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

sound-fx

sound-fx

Generate any sound effect from a text description — footsteps, explosions, cartoon boings, ambient rain, or whatever you can imagine.
根据文本描述生成任意音效——脚步声、爆炸声、卡通弹跳声、环境雨声，或是任何你能想象到的声音。

Triggers

触发场景

  • sound effect / sfx / foley
  • generate sound / make a sound / create audio
  • ambient sound / background noise
  • what does X sound like / make the sound of X
  • 音效 / 声音 / 音频效果
  • sound effect / sfx / foley
  • generate sound / make a sound / create audio
  • ambient sound / background noise
  • what does X sound like / make the sound of X
  • 音效 / 声音 / 音频效果

Quick Start

快速开始

bash
undefined
bash
undefined

Animals

Animals

python3 skills/sound-fx/scripts/sfx.py "a cat purring contentedly, deep rumbling vibration" -d 8 python3 skills/sound-fx/scripts/sfx.py "dog sneezing three times in a row" -d 3 python3 skills/sound-fx/scripts/sfx.py "dog eating food really fast, chomping and gulping" -d 4
python3 skills/sound-fx/scripts/sfx.py "a cat purring contentedly, deep rumbling vibration" -d 8 python3 skills/sound-fx/scripts/sfx.py "dog sneezing three times in a row" -d 3 python3 skills/sound-fx/scripts/sfx.py "dog eating food really fast, chomping and gulping" -d 4

Funny

Funny

python3 skills/sound-fx/scripts/sfx.py "cartoon character getting spanked, exaggerated squeaky yelp" -d 2 python3 skills/sound-fx/scripts/sfx.py "someone sitting on a whoopee cushion mid-meeting" -d 2
python3 skills/sound-fx/scripts/sfx.py "cartoon character getting spanked, exaggerated squeaky yelp" -d 2 python3 skills/sound-fx/scripts/sfx.py "someone sitting on a whoopee cushion mid-meeting" -d 2

Ambient (save to file)

Ambient (save to file)

python3 skills/sound-fx/scripts/sfx.py "heavy rain on a tin roof" -d 15 -o rain.wav python3 skills/sound-fx/scripts/sfx.py "campfire crackling at night, crickets in background" -d 15 -o campfire.wav
undefined
python3 skills/sound-fx/scripts/sfx.py "heavy rain on a tin roof" -d 15 -o rain.wav python3 skills/sound-fx/scripts/sfx.py "campfire crackling at night, crickets in background" -d 15 -o campfire.wav
undefined

Arguments

参数说明

ArgumentDefaultDescription
prompt
requiredText description of the sound to generate
--duration
/ 
-d
autoLength in seconds (1–30). Omit to let the model decide.
--format
/ 
-f
wav
Output format: 
wav
, 
mp3
, 
flac
--output
/ 
-o
output.wav
Path to save the generated audio
--api-key
from env/configNoiz API key (overrides stored key)
参数默认值描述
prompt
必填要生成的声音的文本描述
--duration
/ 
-d
自动时长（秒，范围1–30）。省略则由模型自动决定。
--format
/ 
-f
wav
输出格式：
wav
, 
mp3
, 
flac
--output
/ 
-o
output.wav
生成音频的保存路径
--api-key
来自环境变量/配置文件Noiz API密钥（会覆盖已存储的密钥）

Configuration

配置

bash
undefined
bash
undefined

Save your API key once

一次性保存API密钥

python3 skills/sound-fx/scripts/sfx.py config --set-api-key YOUR_KEY
python3 skills/sound-fx/scripts/sfx.py config --set-api-key YOUR_KEY

Or set via environment variable

或通过环境变量设置

export NOIZ_API_KEY=YOUR_KEY

Get your API key at [developers.noiz.ai](https://developers.noiz.ai/api-keys).
export NOIZ_API_KEY=YOUR_KEY

请访问[developers.noiz.ai](https://developers.noiz.ai/api-keys)获取您的API密钥。

Fun Example Prompts

趣味示例提示词

🐾 Animals

🐾 动物

PromptSuggested Duration
"a cat purring contentedly, deep rumbling vibration"
8s
"cat hissing and yowling aggressively"
3s
"cat knocking a glass off the table, crash"
2s
"dog sneezing three times in a row"
3s
"small dog barking excitedly at a doorbell"
4s
"dog howling dramatically at the moon"
5s
"dog eating food really fast, chomping and gulping"
4s
"hamster running furiously on a squeaky wheel"
6s
"parrot perfectly mimicking a phone ringing"
3s
"frog croaking in a pond at night"
8s
提示词建议时长
"a cat purring contentedly, deep rumbling vibration"
8s
"cat hissing and yowling aggressively"
3s
"cat knocking a glass off the table, crash"
2s
"dog sneezing three times in a row"
3s
"small dog barking excitedly at a doorbell"
4s
"dog howling dramatically at the moon"
5s
"dog eating food really fast, chomping and gulping"
4s
"hamster running furiously on a squeaky wheel"
6s
"parrot perfectly mimicking a phone ringing"
3s
"frog croaking in a pond at night"
8s

😂 Funny & Expressive

😂 趣味与表现力

PromptSuggested Duration
"cartoon character getting spanked, exaggerated squeaky yelp"
2s
"dramatic fail horn (wah wah wah wah)"
3s
"someone sitting on a whoopee cushion mid-meeting"
2s
"anime power-up charging sound"
5s
"someone slipping on a banana peel, cartoon slide and crash"
3s
"dramatic chipmunk stare — suspenseful strings"
3s
"rubber duck squeak three times"
2s
"evil villain laugh echoing in a dungeon"
5s
"crowd gasping in disbelief"
3s
"a notification sound that sounds passive-aggressive"
2s
"someone aggressively typing on a mechanical keyboard"
5s
提示词建议时长
"cartoon character getting spanked, exaggerated squeaky yelp"
2s
"dramatic fail horn (wah wah wah wah)"
3s
"someone sitting on a whoopee cushion mid-meeting"
2s
"anime power-up charging sound"
5s
"someone slipping on a banana peel, cartoon slide and crash"
3s
"dramatic chipmunk stare — suspenseful strings"
3s
"rubber duck squeak three times"
2s
"evil villain laugh echoing in a dungeon"
5s
"crowd gasping in disbelief"
3s
"a notification sound that sounds passive-aggressive"
2s
"someone aggressively typing on a mechanical keyboard"
5s

🌍 Ambient & Atmosphere

🌍 环境与氛围

PromptSuggested Duration
"heavy rain and thunder on a metal roof"
15s
"busy coffee shop, background chatter and espresso machine"
15s
"old dial-up modem connecting to the internet"
10s
"campfire crackling at night, crickets in background"
15s
"ocean waves gently crashing on a beach"
15s
提示词建议时长
"heavy rain and thunder on a metal roof"
15s
"busy coffee shop, background chatter and espresso machine"
15s
"old dial-up modem connecting to the internet"
10s
"campfire crackling at night, crickets in background"
15s
"ocean waves gently crashing on a beach"
15s

🎮 Action & Sci-Fi

🎮 动作与科幻

PromptSuggested Duration
"spaceship laser blaster"
2s
"monster truck engine revving"
5s
"sword being unsheathed from scabbard"
2s
"video game level-up fanfare"
3s
提示词建议时长
"spaceship laser blaster"
2s
"monster truck engine revving"
5s
"sword being unsheathed from scabbard"
2s
"video game level-up fanfare"
3s

Output

输出

On success, the audio file is saved to the output path and the URL is printed:
✓ Saved to output.wav (3.2s, 282 KB)
  URL: https://storage.googleapis.com/...
生成成功后，音频文件将保存到指定输出路径，并打印对应的URL：
✓ Saved to output.wav (3.2s, 282 KB)
  URL: https://storage.googleapis.com/...

Third-Party Integration

第三方集成

To send generated sound effects to Discord, Telegram, Feishu, or mix them into videos with ffmpeg, see ref_3rd_party.md.
如需将生成的音效发送至Discord、Telegram、飞书，或使用ffmpeg将其混入视频，请查看ref_3rd_party.md。

Requirements

要求

  • Python 3.6及以上版本
  • requests
    包：
    pip install requests
  • 从developers.noiz.ai获取Noiz API密钥

Security & Data Disclosure

安全与数据披露

  • API key: Stored in 
    ~/.config/noiz/api_key
    (permissions 
    0600
    ) or via 
    NOIZ_API_KEY
    env variable.
  • Network: The text prompt is sent to 
    https://noiz.ai/v1/text-to-sound
    for generation. No other data is transmitted.
  • Output: Generated audio is downloaded from a Noiz GCS URL and saved locally.
  • API密钥：存储在
    ~/.config/noiz/api_key
    （权限为
    0600
    ）中，或通过
    NOIZ_API_KEY
    环境变量设置。
  • 网络传输：文本提示词会发送至
    https://noiz.ai/v1/text-to-sound
    进行生成，无其他数据传输。
  • 输出文件：生成的音频将从Noiz GCS URL下载并保存到本地。