Communitygithub.com

sound-fx

Générez des effets sonores, de l'audio ambiant ou de courts clips audio à partir d'une description textuelle.

Qu'est-ce que sound-fx ?

Cette compétence permet à un agent IA (comme Claude Code, Cursor ou Codex) de générer instantanément des effets sonores à partir d'une simple description textuelle. Elle est idéale pour enrichir des projets multimédias, des démonstrations, des jeux ou des vidéos avec des sons réalistes ou humoristiques. Elle s'appuie sur l'API Noiz.ai pour la synthèse audio et offre de nombreux exemples prêts à l'emploi, allant des animaux aux ambiances en passant par les bruits comiques. L'agent exécute un script Python local (`sfx.py`) qui envoie le prompt à l'API Noiz, récupère le fichier audio généré et le sauvegarde localement. La compétence supporte les arguments de durée, de format de sortie (WAV, MP3, FLAC), et la configuration d'une clé API. Elle peut également être intégrée à des outils tiers comme Discord ou ffmpeg pour une utilisation avancée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/noizai/skills/tree/main/skills/sound-fx

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait sound-fx ?

Générez n'importe quel effet sonore à partir d'une description textuelle — pas de pas, explosions, bruits de dessin animé, pluie ambiante, ou tout ce que vous pouvez imaginer.

Déclencheurs

  • effet sonore / sfx / bruitage
  • générer un son / faire un bruit / créer un fichier audio
  • son ambiant / bruit de fond
  • à quoi ressemble X / fais le son de X
  • 音效 / 声音 / 音频效果 (déclencheurs multilingues)

Démarrage rapide

# Animaux
python3 skills/sound-fx/scripts/sfx.py "un chat ronronnant avec contentement, vibration grave et profonde" -d 8
python3 skills/sound-fx/scripts/sfx.py "chien qui éternue trois fois de suite" -d 3
python3 skills/sound-fx/scripts/sfx.py "chien qui mange très vite, en mâchant et en avalant bruyamment" -d 4

# Drôle
python3 skills/sound-fx/scripts/sfx.py "personnage de dessin animé se faisant fesser, couinement exagéré" -d 2
python3 skills/sound-fx/scripts/sfx.py "quelqu'un s'assoit sur un coussin péteur en pleine réunion" -d 2

# Ambiant (sauvegarder dans un fichier)
python3 skills/sound-fx/scripts/sfx.py "forte pluie sur un toit en tôle" -d 15 -o pluie.wav
python3 skills/sound-fx/scripts/sfx.py "feu de camp qui crépite la nuit, grillons en arrière-plan" -d 15 -o camping.wav

Arguments

ArgumentDéfautDescription
promptrequisDescription textuelle du son à générer
--duration / -dautoDurée en secondes (1–30). Omettre pour laisser le modèle décider.
--format / -fwavFormat de sortie : wav, mp3, flac
--output / -ooutput.wavChemin de sauvegarde du fichier audio généré
--api-keyde env/configClé API Noiz (remplace la clé stockée)

Configuration

# Sauvegarder votre clé API une fois
python3 skills/sound-fx/scripts/sfx.py config --set-api-key VOTRE_CLE

# Ou définir via variable d'environnement
export NOIZ_API_KEY=VOTRE_CLE

Obtenez votre clé API sur developers.noiz.ai.

Exemples de prompts amusants

Animaux 🐾

PromptDurée suggérée
"un chat ronronnant avec contentement, vibration grave et profonde"8s
"chat qui siffle et miaule agressivement"3s
"chat qui fait tomber un verre de la table, fracas"2s
"chien qui éternue trois fois de suite"3s
"petit chien qui aboie avec excitation à la sonnette"4s
"chien hurlant de manière dramatique à la lune"5s
"chien qui mange très vite, en mâchant et en avalant bruyamment"4s
"hamster courant frénétiquement sur une roue qui grince"6s
"perroquet imitant parfaitement une sonnerie de téléphone"3s
"grenouille coassant dans un étang la nuit"8s

Drôle & Expressif 😂

PromptDurée suggérée
"personnage de dessin animé se faisant fesser, couinement exagéré"2s
"cor dramatique de l'échec (wah wah wah wah)"3s
"quelqu'un s'assoit sur un coussin péteur en pleine réunion"2s
"son de charge d'énergie anime"5s
"quelqu'un qui glisse sur une peau de banane, glissade et fracas de dessin animé"3s
"regard dramatique de spermophile de l'Himalaya — cordes pleines de suspense"3s
"canard en caoutchouc qui couine trois fois"2s
"rire de méchant résonnant dans un donjon"5s
"foule qui halète d'incrédulité"3s
"un son de notification passif-agressif"2s
"quelqu'un qui tape agressivement sur un clavier mécanique"5s

Ambiant & Atmosphère 🌍

PromptDurée suggérée
"forte pluie et tonnerre sur un toit en tôle"15s
"café animé, bavardages en fond et machine à expresso"15s
"vieux modem commuté qui se connecte à Internet"10s
"feu de camp qui crépite la nuit, grillons en arrière-plan"15s
"vagues de l'océan qui se brisent doucement sur une plage"15s

Action & Science-Fiction 🎮

PromptDurée suggérée
"blaster laser de vaisseau spatial"2s
"moteur de monster truck qui rugit"5s
"épée dégainée de son fourreau"2s
"fanfare de passage de niveau dans un jeu vidéo"3s

Sortie

En cas de succès, le fichier audio est sauvegardé au chemin spécifié et l'URL est affichée :

✓ Sauvegardé dans output.wav (3.2s, 282 Ko)
  URL : https://storage.googleapis.com/...

Intégration tierce

Pour envoyer des effets sonores générés vers Discord, Telegram, Feishu ou les mixer dans des vidéos avec ffmpeg, voir ref_3rd_party.md.

Prérequis

  • Python 3.6+
  • Paquet requests : pip install requests
  • Clé API Noiz depuis developers.noiz.ai

Sécurité et divulgation des données

  • Clé API : Stockée dans ~/.config/noiz/api_key (permissions 0600) ou via la variable d'environnement NOIZ_API_KEY.
  • Réseau : Le prompt textuel est envoyé à https://noiz.ai/v1/text-to-sound pour la génération. Aucune autre donnée n'est transmise.
  • Sortie : L'audio généré est téléchargé depuis une URL GCS Noiz et sauvegardé localement.

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Skills associés