¿Qué hace sound-fx (efectos de sonido)?
Genera cualquier efecto de sonido a partir de una descripción de texto: pasos, explosiones, sonidos de caricatura, lluvia ambiental o lo que puedas imaginar.
Disparadores
- efecto de sonido / sfx / foley
- generar sonido / hacer un sonido / crear audio
- sonido ambiental / ruido de fondo
- ¿cómo suena X? / haz el sonido de X
- 音效 / 声音 / 音频效果
Inicio rápido
python3 skills/sound-fx/scripts/sfx.py "un gato ronroneando plácidamente, vibración profunda" -d 8
python3 skills/sound-fx/scripts/sfx.py "perro estornudando tres veces seguidas" -d 3
python3 skills/sound-fx/scripts/sfx.py "perro comiendo muy rápido, masticando y tragando" -d 4
python3 skills/sound-fx/scripts/sfx.py "personaje de caricatura recibiendo una nalgada, chillido exagerado" -d 2
python3 skills/sound-fx/scripts/sfx.py "alguien sentándose sobre un cojín pedorro en medio de una reunión" -d 2
python3 skills/sound-fx/scripts/sfx.py "lluvia intensa sobre un techo de metal" -d 15 -o lluvia.wav
python3 skills/sound-fx/scripts/sfx.py "fogata crepitando de noche, grillos de fondo" -d 15 -o fogata.wav
Argumentos
| Argumento | Por defecto | Descripción |
|---|
prompt | obligatorio | Descripción de texto del sonido a generar |
--duration / -d | auto | Duración en segundos (1–30). Omítelo para que el modelo decida. |
--format / -f | wav | Formato de salida: wav, mp3, flac |
--output / -o | output.wav | Ruta para guardar el audio generado |
--api-key | desde env/config | Clave de API de Noiz (sobrescribe la clave almacenada) |
Configuración
python3 skills/sound-fx/scripts/sfx.py config --set-api-key TU_CLAVE
export NOIZ_API_KEY=TU_CLAVE
Obtén tu clave de API en developers.noiz.ai.
Ejemplos Divertidos de Prompt
🐾 Animales
| Prompt | Duración sugerida |
|---|
"un gato ronroneando plácidamente, vibración profunda" | 8s |
"gato bufando y maullando agresivamente" | 3s |
"gato tirando un vaso de la mesa, estruendo" | 2s |
"perro estornudando tres veces seguidas" | 3s |
"perro pequeño ladrando emocionado al timbre" | 4s |
"perro aullando dramáticamente a la luna" | 5s |
"perro comiendo muy rápido, masticando y tragando" | 4s |
"hámster corriendo furiosamente en una rueda chirriante" | 6s |
"loro imitando perfectamente el sonido de un teléfono" | 3s |
"rana croando en un estanque por la noche" | 8s |
😂 Divertidos y expresivos
| Prompt | Duración sugerida |
|---|
"personaje de caricatura recibiendo una nalgada, chillido exagerado" | 2s |
"bocina dramática de fracaso (wah wah wah wah)" | 3s |
"alguien sentándose sobre un cojín pedorro en medio de una reunión" | 2s |
"sonido de carga de poder anime" | 5s |
"alguien resbalando en una cáscara de plátano, deslizamiento y estrépito de caricatura" | 3s |
"mirada dramática de ardilla - cuerdas de suspenso" | 3s |
"chirrido de patito de goma tres veces" | 2s |
"risa de villano malvado resonando en una mazmorra" | 5s |
"multitud jadeando de incredulidad" | 3s |
"sonido de notificación que suena pasivo-agresivo" | 2s |
"alguien escribiendo agresivamente en un teclado mecánico" | 5s |
🌍 Ambiente y atmósfera
| Prompt | Duración sugerida |
|---|
"lluvia intensa y truenos sobre un techo de metal" | 15s |
"cafetería llena, charlas de fondo y máquina de espresso" | 15s |
"módem antiguo de marcado conectándose a internet" | 10s |
"fogata crepitando de noche, grillos de fondo" | 15s |
"olas del mar rompiendo suavemente en una playa" | 15s |
🎮 Acción y ciencia ficción
| Prompt | Duración sugerida |
|---|
"disparo láser de nave espacial" | 2s |
"motor de camión monstruo acelerando" | 5s |
"espada siendo desenvainada de su funda" | 2s |
"fanfarria de subida de nivel de videojuego" | 3s |
Salida
En caso de éxito, el archivo de audio se guarda en la ruta de salida y se imprime la URL:
✓ Guardado en output.wav (3.2s, 282 KB)
URL: https://storage.googleapis.com/...
Integración de terceros
Para enviar efectos de sonido generados a Discord, Telegram, Feishu, o mezclarlos en videos con ffmpeg, consulta ref_3rd_party.md.
Requisitos
- Python 3.6+
- Paquete
requests: pip install requests
- Clave de API de Noiz desde developers.noiz.ai
Seguridad y divulgación de datos
- Clave de API: Almacenada en
~/.config/noiz/api_key (permisos 0600) o mediante la variable de entorno NOIZ_API_KEY.
- Red: El prompt de texto se envía a
https://noiz.ai/v1/text-to-sound para la generación. No se transmite ningún otro dato.
- Salida: El audio generado se descarga desde una URL de GCS de Noiz y se guarda localmente.