翻译音频文件
已上线上传一段录音，换成另一种语言返回，用你自己的声音或预置声音朗读，并附带转写文本和译文。
翻译音频文件
真实示例翻译示例
泰语译为英语 · 这是该工具的真实运行结果，你自己的运行结果会替换它。
说话内容
字幕
- สวัสดีค่ะ ยินดีต้อนรับสู่ร้านกาแฟของเรา วันนี้เรามีเค้กช็อกโกแลตตอบใหม่ๆ ลองชิมดูไหมคะHello, and welcome to our coffee shop. Today we have fresh chocolate cakes. Want to try them?
翻译后的声音
翻译音频文件 API
发送音频文件链接，获得一个任务，返回翻译后的语音、转写文本和译文。
https:/- GET
/查询翻译任务v1/ tasks/ {id}
获取 API 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥发送第一个请求
与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。
curl https://api.opennan.com/v1/audio/translations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"audio_url":"https://example.com/talk.mp3","source_lang":"auto","target_lang":"en","voice_id":"vc_your_voice"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"查询任务
调用会立即返回任务 ID。查询任务直到完成：
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- 等待处理
- running
- 生成中
- succeeded
- 完成：outputs[].url 中是文件
- failed
- 失败：不收费
错误及解决方法
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 服务器加到你的智能体中，然后调用此工具。
- 工具
- translate_audio
- 示例参数
{ "audio_url": "https://example.com/talk.mp3", "target_lang": "en", "voice_id": "vc_your_voice" }
翻译音频文件：常见问题
翻译音频文件怎么收费？
按输入音频计 $0.3597/分钟。失败的任务不收费。
怎么调用？
携带 API 密钥发送 POST https://api.opennan.com/v1/audio/translations。它返回一个任务；轮询 https://api.opennan.com/v1/tasks/{id}，直到状态为 succeeded 或 failed。
出错时会收费吗？
不会。失败的步骤不收费，并会用通俗的话说明原因。
可以用别人的声音吗？
不可以。你只能克隆自己的声音，并需要录下你朗读我们提供的同意句子。声音绝不会在账户之间共享。
我的 AI 智能体能用吗？
可以。把它指向 MCP 服务器 https://api.opennan.com/v1/mcp（工具 translate_audio），或让它阅读 https://api.opennan.com/llms.txt。