mcpField
S
sound-fx

sound-fx

github.com/noizai创意与媒体531371 次安装4 周前更新
代码仓库

关于 sound-fx

这是一个通过文本描述生成音效的 Skill，使用脚本调用 Noiz 服务。它支持设置时长和输出格式，并将生成的音频保存到本地。

主要功能

  1. 01根据文本提示生成音效
  2. 02设置 1 至 30 秒时长
  3. 03保存为 WAV、MP3 或 FLAC
  4. 04通过环境变量或命令配置 API 密钥
  5. 05提供多类声音的示例提示

适用场景

  1. 01制作动物或卡通音效
  2. 02为音频或视频生成环境声
  3. 03制作简短的游戏或界面音效

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/noizai/skills --skill sound-fx

安装后在 Claude Code 中输入/sound-fx确认已加载。

附带文件ref_3rd_party.mdscripts/sfx.py

详细介绍

sound-fx

根据文本描述生成任意音效——脚步声、爆炸声、卡通弹跳声、环境雨声，或任何你能想到的声音。

触发词

  • 音效 / sfx / 拟音
  • 生成声音 / 制作声音 / 创建音频
  • 环境音 / 背景噪声
  • X 听起来是什么样 / 制作 X 的声音
  • 音效 / 声音 / 音频效果

快速开始

# 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

# 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

# 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

参数

参数默认值描述
prompt必填要生成的声音的文本描述
--duration / -d自动时长（秒），范围为 1–30。省略后由模型决定。
--format / -fwav输出格式：wav、mp3、flac
--output / -ooutput.wav保存生成音频的路径
--api-key来自环境变量/配置Noiz API 密钥（覆盖已保存的密钥）

配置

# Save your API key once
python3 skills/sound-fx/scripts/sfx.py config --set-api-key YOUR_KEY

# Or set via environment variable
export NOIZ_API_KEY=YOUR_KEY

在 developers.noiz.ai 获取 API 密钥。

趣味示例提示词

🐾 动物
提示词建议时长
"一只猫满足地呼噜，发出低沉的隆隆振动声"8s
"猫愤怒地嘶叫并嚎叫"3s
"猫把桌上的玻璃杯打落，发出碎裂声"2s
"狗连续打三次喷嚏"3s
"小狗兴奋地对着门铃叫"4s
"狗对着月亮戏剧性地嚎叫"5s
"狗狼吞虎咽地吃东西，发出咀嚼和吞咽声"4s
"仓鼠在吱吱作响的跑轮上疯狂奔跑"6s
"鹦鹉惟妙惟肖地模仿电话铃声"3s
"夜晚池塘里的青蛙呱呱叫"8s
😂 搞笑与富有表现力
提示词建议时长
"卡通角色被打屁股，夸张地发出尖叫"2s
"戏剧性的失败号角声（哇哇哇哇）"3s
"有人在会议中坐到放屁垫上"2s
"动漫能量蓄积音效"5s
"有人踩到香蕉皮滑倒，卡通式滑行并摔倒"3s
"戏剧化的土拨鼠凝视——悬疑弦乐"3s
"橡皮鸭吱吱叫三次"2s
"邪恶反派在地牢里回荡着大笑"5s
"人群难以置信地倒吸一口气"3s
"听起来带着被动攻击意味的通知音"2s
"有人在机械键盘上用力敲打"5s
🌍 环境与氛围
提示词建议时长
"金属屋顶上的大雨和雷声"15s
"热闹的咖啡馆，背景交谈声和意式浓缩咖啡机声"15s
"老式拨号调制解调器连接互联网"10s
"夜晚篝火噼啪作响，背景中有蟋蟀声"15s
"海浪轻轻拍打海滩"15s
🎮 动作与科幻
提示词建议时长
"宇宙飞船激光炮"2s
"怪兽卡车发动机轰鸣加速"5s
"从剑鞘中拔出剑"2s
"电子游戏关卡升级庆祝乐曲"3s

输出

成功后，音频文件会保存到输出路径，并打印 URL：

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

第三方集成

如需将生成的音效发送到 Discord、Telegram、飞书，或使用 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 下载并保存到本地。

评论

支持 Markdown