sound-fx

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 / -f	wav	出力形式：wav、mp3、flac
--output / -o	output.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
"犬が続けて3回くしゃみをする"	3s
"小型犬がドアベルに興奮して吠える"	4s
"犬が月に向かってドラマチックに遠吠えする"	5s
"犬が食べ物をものすごい速さで食べ、むしゃむしゃと飲み込む"	4s
"ハムスターがきしむ回し車の上を猛烈に走る"	6s
"オウムが電話の着信音を完璧にまねる"	3s
"夜の池でカエルが鳴く"	8s

😂 おもしろ系・表現豊かな音

プロンプト	推奨時間
"漫画のキャラクターがお尻を叩かれ、大げさな甲高い悲鳴を上げる"	2s
"ドラマチックな失敗のファンファーレ（ワーワーワーワー）"	3s
"会議中に誰かがブーブークッションに座る"	2s
"アニメのパワーアップ時のチャージ音"	5s
"誰かがバナナの皮で滑り、漫画のように滑って転ぶ"	3s
"ドラマチックなシマリスの凝視 — 緊迫感のある弦楽器"	3s
"ラバーダックが3回きしむ"	2s
"悪役の笑い声がダンジョンに響く"	5s
"群衆が信じられない様子で息をのむ"	3s
"受動攻撃的に聞こえる通知音"	2s
"誰かがメカニカルキーボードを激しくタイピングする"	5s

🌍 環境音・雰囲気

プロンプト	推奨時間
"金属屋根に激しい雨が降り、雷が鳴る"	15s
"にぎやかなコーヒーショップ、背景の話し声とエスプレッソマシン"	15s
"古いダイヤルアップモデムがインターネットに接続する"	10s
"夜にたき火がパチパチと燃え、背景でコオロギが鳴く"	15s
"浜辺に穏やかに打ち寄せる海の波"	15s

🎮 アクション・SF

プロンプト	推奨時間
"宇宙船のレーザーブラスター"	2s
"モンスタートラックのエンジンがうなる"	5s
"鞘から剣を抜く"	2s
"ビデオゲームのレベルアップ時のファンファーレ"	3s

出力

成功すると、オーディオファイルが出力先のパスに保存され、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 からダウンロードされ、ローカルに保存されます。