Sound effects
Ao vivoDescribe a sound. Get it back as audio in the same response: footsteps on gravel, heavy rain, a door slam, a whoosh, up to 22 seconds long.
Como funciona
- 01Describe the soundWhat it is and how it should feel, up to 1,000 characters.
- 02We make itOne sound, as long as you ask for.
- 03Get the audioMP3, WAV or Opus, in the same response.
Chame Sound effects pelo seu código
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/Pegue uma chave de API
Crie uma chave no console. Ela usa o mesmo saldo do playground.
Criar uma chaveEnvie sua primeira requisição
A mesma requisição que o playground envia. Defina OPENNAN_KEY com sua chave.
curl https://api.opennan.com/v1/audio/sound-effects \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"text":"heavy rain on a tin roof with distant thunder","duration_seconds":5}' \ --output sound.mp3Leia o resultado
O resultado vem na mesma resposta. O cabeçalho X-Usage-Cost-Usd informa quanto a chamada custou.
Erros e como resolver
401Chave ausente ou errada
Envie o cabeçalho Authorization: Bearer com uma chave do console.
402Saldo insuficiente
Adicione crédito em Faturamento e envie a mesma chamada de novo.
400Um valor não é aceito
Leia error.message: ele indica o campo. Use um valor da tabela de parâmetros.
429Requisições demais
Aguarde alguns segundos e tente de novo, esperando mais após cada 429.
Adicione a Opennan ao seu app de IA
Uma instalação dá à sua IA todas as ferramentas da Opennan: vídeo, imagens, chat, voz, música, efeitos sonoros, 3D, legendas e dublagem. Escolha seu app e siga os passos.
https:/Funciona no Codex CLI, no app do Codex e na extensão do Codex para IDE: todos usam ~/.codex/config.toml. Se o app ou a IDE não enxergar OPENNAN_KEY, use a opção config.toml com sua chave. O Codex pede aprovação antes de cada ferramenta: aprove para seguir.
Pegue uma chave de API
Crie uma chave no console. Ela começa com sk- e usa o mesmo saldo do site.
Criar uma chaveSalve sua chave como OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Instale o plugin da Opennan: o servidor e uma skill que ensina sua IA a escolher modelos, confirmar preços e esperar os resultados
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOu adicione só o servidor
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOu adicione isto a ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Confira se opennan aparece na lista
codex mcp listReinicie o Codex e peça o que quiser
“Faça um vídeo de 5 segundos de chuva numa rua de neon, uma música para acompanhar e uma imagem de pôster.”
Troque sk-... pela sua chave e mantenha-a em segredo: quem tiver a chave pode gastar seu saldo. Seu app lista as ferramentas sem chave; para criar algo, você precisa de uma.
Use a partir de um agente de IA
Adicione o servidor MCP da Opennan ao seu agente e chame esta ferramenta.
- Ferramenta
- generate_sfx
- Argumentos de exemplo
{ "text": "heavy rain on a tin roof with distant thunder", "duration_seconds": 5 }
Sound effects: perguntas
Quanto custa Sound effects?
$0.0026 per second. The Run button shows the exact price for your input before you start.
Como chamo pelo meu código?
Envie POST https://api.opennan.com/v1/audio/sound-effects com sua chave de API. O resultado vem na mesma resposta.
Meu agente de IA pode usar?
Sim. Adicione o servidor MCP https://api.opennan.com/v1/mcp e chame a ferramenta generate_sfx, ou aponte seu agente para https://api.opennan.com/llms.txt.
O que acontece se uma execução falhar?
Uma execução com falha não é cobrada. Você paga só pelos resultados.