Sound effects
已上线Describe 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.
运作方式
- 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.
从代码调用 Sound effects
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/获取 API 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥发送第一个请求
与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。
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.mp3读取结果
结果在同一个响应里返回。X-Usage-Cost-Usd 响应头写明本次调用的费用。
错误及解决方法
401缺少密钥或密钥错误
用 Authorization: Bearer 请求头发送控制台中的密钥。
402余额不足
在账单页面充值，然后重新发送同一请求。
400有值不被接受
查看 error.message，它会指出字段。请使用参数表中的值。
429请求过多
等几秒再试，每次遇到 429 都等得更久一些。
把 Opennan 添加到你的 AI 应用
安装一次，你的 AI 就能使用 Opennan 的全部工具：视频、图片、聊天、语音、音乐、音效、3D、字幕和配音。选择你的应用，按步骤操作。
https:/适用于 Codex CLI、Codex 应用和 Codex IDE 扩展：它们共用 ~/.codex/config.toml。如果应用或 IDE 读不到 OPENNAN_KEY，请用写入密钥的 config.toml 方式。Codex 每次调用工具前会询问，批准即可继续。
把密钥保存为 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-..."安装 Opennan 插件：包含服务器，以及教 AI 选择模型、确认价格、等待结果的技能
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennan或者只添加服务器
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY或者把这段加到 ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }确认列表里有 opennan
codex mcp list重启 Codex，然后让它做任何事
“做一段 5 秒的霓虹街道下雨视频，再配一首歌和一张海报图。”
把 sk-... 换成你自己的密钥并妥善保管：拿到它的人可以花你的余额。没有密钥时应用也能列出工具，但生成内容需要密钥。
在 AI 智能体中使用
把 Opennan MCP 服务器加到你的智能体中，然后调用此工具。
- 工具
- generate_sfx
- 示例参数
{ "text": "heavy rain on a tin roof with distant thunder", "duration_seconds": 5 }
Sound effects：常见问题
Sound effects 多少钱？
$0.0026 per second. The Run button shows the exact price for your input before you start.
如何从代码调用？
带上 API 密钥发送 POST https://api.opennan.com/v1/audio/sound-effects。结果在同一个响应里返回。
我的 AI 智能体能用吗？
能。添加 MCP 服务器 https://api.opennan.com/v1/mcp 并调用 generate_sfx 工具，或让智能体阅读 https://api.opennan.com/llms.txt。
运行失败会怎样？
失败的运行不收费。只为结果付费。