sound-fx は何をしますか？
テキストの説明からあらゆる効果音を生成 — 足音、爆発音、漫画のブーンという音、アンビエントな雨音、想像できるあらゆる音に対応。
トリガー
- 効果音 / sfx / フォーリー
- 音を生成 / 音を作る / オーディオを作成
- アンビエントサウンド / 背景音
- Xはどんな音？ / Xの音を出して
- 音效 / 声音 / 音频效果
クイックスタート
python3 skills/sound-fx/scripts/sfx.py "満足そうにゴロゴロと喉を鳴らす猫、深く響く振動" -d 8
python3 skills/sound-fx/scripts/sfx.py "犬が3回続けてくしゃみをする" -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 | env/configから | Noiz APIキー（保存済みキーを上書き） |
設定
python3 skills/sound-fx/scripts/sfx.py config --set-api-key YOUR_KEY
export NOIZ_API_KEY=YOUR_KEY
APIキーは developers.noiz.ai で取得してください。
楽しいプロンプト例
🐾 動物
| プロンプト | 推奨時間 |
|---|
"満足そうにゴロゴロと喉を鳴らす猫、深く響く振動" | 8秒 |
"猫が激しくシューッと鳴き、威嚇する" | 3秒 |
"猫がテーブルからグラスを落とす、ガシャン" | 2秒 |
"犬が3回続けてくしゃみをする" | 3秒 |
"小さな犬がインターホンに興奮して吠える" | 4秒 |
"犬が月に向かってドラマチックに遠吠えする" | 5秒 |
"犬がすごい勢いで餌を食べる、かみ砕く音と飲み込む音" | 4秒 |
"ハムスターがきしむホイールを猛烈な勢いで走る" | 6秒 |
"オウムが電話の着信音を完璧に真似る" | 3秒 |
"夜の池で蛙が鳴く" | 8秒 |
😂 面白い＆表情豊か
| プロンプト | 推奨時間 |
|---|
"漫画のキャラクターがお尻を叩かれる、大げさなキーキー鳴くような叫び声" | 2秒 |
"ドラマチックな失敗のホルン（ワワワワワー）" | 3秒 |
"会議中に誰かがプープークッションに座る" | 2秒 |
"アニメのパワーアップチャージ音" | 5秒 |
"誰かがバナナの皮で滑る、漫画のようなスライドと衝突音" | 3秒 |
"ドラマチックなシマリスの凝視 — サスペンスフルな弦楽器" | 3秒 |
"ゴム製アヒルのおもちゃのきしむ音を3回" | 2秒 |
"邪悪な悪役の笑い声がダンジョンに響き渡る" | 5秒 |
"群衆が信じられない思いで息を呑む" | 3秒 |
"受動的攻撃的に聞こえる通知音" | 2秒 |
"誰かがメカニカルキーボードを激しくタイピングする" | 5秒 |
🌍 アンビエント＆雰囲気
| プロンプト | 推奨時間 |
|---|
"金属の屋根に降り注ぐ激しい雨と雷" | 15秒 |
"繁盛しているコーヒーショップ、背景の会話とエスプレッソマシン" | 15秒 |
"古いダイヤルアップモデムがインターネットに接続する音" | 10秒 |
"夜の焚き火のパチパチという音、背景にコオロギの鳴き声" | 15秒 |
"海の波が穏やかに浜辺に打ち寄せる" | 15秒 |
🎮 アクション＆SF
| プロンプト | 推奨時間 |
|---|
"宇宙船のレーザーブラスター" | 2秒 |
"モンスタートラックのエンジンが吹かす音" | 5秒 |
"鞘から剣を抜く音" | 2秒 |
"ビデオゲームのレベルアップファンファーレ" | 3秒 |
出力
成功すると、オーディオファイルが出力パスに保存され、URLが表示されます:
✓ output.wav に保存しました（3.2秒、282 KB）
URL: https://storage.googleapis.com/...
サードパーティ統合
生成された効果音をDiscord、Telegram、Feishuに送信したり、ffmpegで動画にミックスするには、ref_3rd_party.mdを参照してください。
要件
セキュリティとデータ開示
- APIキー:
~/.config/noiz/api_key（パーミッション 0600）または NOIZ_API_KEY 環境変数で保存されます。
- ネットワーク: テキストプロンプトが生成のために
https://noiz.ai/v1/text-to-sound に送信されます。それ以外のデータは送信されません。
- 出力: 生成されたオーディオは、Noiz GCS URLからダウンロードされ、ローカルに保存されます。