O que sound-fx faz?
Gere qualquer efeito sonoro a partir de uma descrição em texto — passos, explosões, boings de desenho animado, chuva ambiente, ou qualquer coisa que você imaginar.
Gatilhos
- efeito sonoro / sfx / foley
- gerar som / criar áudio / fazer um som
- som ambiente / ruído de fundo
- como é o som de X / faça o som de X
- 音效 / 声音 / 音频效果
Início Rápido
python3 skills/sound-fx/scripts/sfx.py "um gato ronronando contente, vibração grave e profunda" -d 8
python3 skills/sound-fx/scripts/sfx.py "cachorro espirrando três vezes seguidas" -d 3
python3 skills/sound-fx/scripts/sfx.py "cachorro comendo comida muito rápido, mastigando e engolindo" -d 4
python3 skills/sound-fx/scripts/sfx.py "personagem de desenho animado levando palmadas, grito exagerado e estridente" -d 2
python3 skills/sound-fx/scripts/sfx.py "alguém sentando em uma almofada peido no meio de uma reunião" -d 2
python3 skills/sound-fx/scripts/sfx.py "chuva forte em telhado de zinco" -d 15 -o chuva.wav
python3 skills/sound-fx/scripts/sfx.py "fogueira crepitando à noite, grilos ao fundo" -d 15 -o fogueira.wav
Argumentos
| Argumento | Padrão | Descrição |
|---|
prompt | obrigatório | Descrição textual do som a ser gerado |
--duration / -d | automático | Duração em segundos (1–30). Omita para deixar o modelo decidir. |
--format / -f | wav | Formato de saída: wav, mp3, flac |
--output / -o | output.wav | Caminho para salvar o áudio gerado |
--api-key | de env/config | Chave da API Noiz (sobrescreve a chave armazenada) |
Configuração
python3 skills/sound-fx/scripts/sfx.py config --set-api-key SUA_CHAVE
export NOIZ_API_KEY=SUA_CHAVE
Obtenha sua chave de API em developers.noiz.ai.
Exemplos Divertidos de Prompts
🐾 Animais
| Prompt | Duração Sugerida |
|---|
"um gato ronronando contente, vibração grave e profunda" | 8s |
"gato sibilando e miando agressivamente" | 3s |
"gato derrubando um copo da mesa, crash" | 2s |
"cachorro espirrando três vezes seguidas" | 3s |
"cachorro pequeno latindo animado para uma campainha" | 4s |
"cachorro uivando dramaticamente para a lua" | 5s |
"cachorro comendo comida muito rápido, mastigando e engolindo" | 4s |
"hamster correndo furiosamente em uma roda barulhenta" | 6s |
"papagaio imitando perfeitamente um telefone tocando" | 3s |
"sapo coaxando em um lago à noite" | 8s |
😂 Engraçado & Expressivo
| Prompt | Duração Sugerida |
|---|
"personagem de desenho animado levando palmadas, grito exagerado e estridente" | 2s |
"buzina de fracasso dramática (wah wah wah wah)" | 3s |
"alguém sentando em uma almofada peido no meio de uma reunião" | 2s |
"som de carregamento de poder estilo anime" | 5s |
"alguém escorregando em uma casca de banana, deslize e crash de desenho" | 3s |
"olhar dramático de esquilo — cordas de suspense" | 3s |
"squeak de pato de borracha três vezes" | 2s |
"risada de vilão maligna ecoando em uma masmorra" | 5s |
"multidão suspirando em descrença" | 3s |
"som de notificação que parece passivo-agressivo" | 2s |
"alguém digitando agressivamente em um teclado mecânico" | 5s |
🌍 Ambiente & Atmosfera
| Prompt | Duração Sugerida |
|---|
"chuva forte e trovões em telhado de metal" | 15s |
"cafeteria movimentada, conversas ao fundo e máquina de espresso" | 15s |
"modem antigo discando conectando-se à internet" | 10s |
"fogueira crepitando à noite, grilos ao fundo" | 15s |
"ondas do mar quebrando suavemente na praia" | 15s |
🎮 Ação & Ficção Científica
| Prompt | Duração Sugerida |
|---|
"laser blaster de nave espacial" | 2s |
"motor de caminhão monstro acelerando" | 5s |
"espada sendo desembainhada da bainha" | 2s |
"fanfarra de subida de nível em videogame" | 3s |
Saída
Após o sucesso, o arquivo de áudio é salvo no caminho de saída e a URL é exibida:
✓ Salvo em output.wav (3.2s, 282 KB)
URL: https://storage.googleapis.com/...
Integração com Terceiros
Para enviar efeitos sonoros gerados para Discord, Telegram, Feishu, ou misturá-los em vídeos com ffmpeg, consulte ref_3rd_party.md.
Requisitos
Segurança e Divulgação de Dados
- Chave de API: Armazenada em
~/.config/noiz/api_key (permissões 0600) ou via variável de ambiente NOIZ_API_KEY.
- Rede: O prompt de texto é enviado para
https://noiz.ai/v1/text-to-sound para geração. Nenhum outro dado é transmitido.
- Saída: O áudio gerado é baixado de uma URL GCS da Noiz e salvo localmente.