文字转语音 API

Q: 文字转语音 API 多少钱？

使用 Kokoro 时 每 100 万字符 $1.287 起，是这里 4 个模型中最便宜的。运行前会显示价格。

Q: 运行失败会怎样？

失败的运行不收费。只为结果付费。

已上线

多种声音和语言的自然配音。

4 个模型，每 100 万字符 $1.287 起最便宜Kokoro

$1.287/百万字符起

输入

文本input要朗读的文字。

162 / 4,096

音色voice音色列表中的音色 ID。

格式response_format

162 个字符162 个字符

示例

示例输出用此提示词生成

Heart

0:00 / 0:00

比较文字转语音 API 模型

此接口的所有模型，价格实时更新。可在试用区试用，或打开模型页面。

Kokorohexgrad每 100 万字符 $1.287
mp3 · wav · opus
页面
Chatterbox TurboResemble AI每 100 万字符 $1.30
mp3 · wav · opus
页面
Chatterbox MultilingualResemble AI每 100 万字符 $1.30
mp3 · wav · opus
页面
Orpheus 3BCanopy Labs每 100 万字符 $9.10
mp3 · wav · opus
页面

此工具的所有模型及价格
		官方价			时长 / 尺寸	操作
Kokorohexgrad	每 100 万字符 $1.287	无官方价	—	mp3 · wav · opus	4K 字符	页面
Chatterbox TurboResemble AI	每 100 万字符 $1.30	无官方价	—	mp3 · wav · opus	4K 字符	页面
Chatterbox MultilingualResemble AI	每 100 万字符 $1.30	无官方价	—	mp3 · wav · opus	4K 字符	页面
Orpheus 3BCanopy Labs	每 100 万字符 $9.10	无官方价	—	mp3 · wav · opus	300 字符	页面

从代码调用文字转语音 API

上面所有模型共用一个接口。改 model 字段即可切换。

POSThttps://api.opennan.com/v1/audio/speech

GET/v1/models?category=voice此接口的所有模型及价格

获取 API 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥

发送第一个请求

与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。

curl https://api.opennan.com/v1/audio/speech \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kokoro","input":"你好！这段语音只用一次 API 调用就生成了。","voice":"heart","response_format":"mp3"}' \
  --output speech.mp3

读取结果
结果在同一个响应里返回。X-Usage-Cost-Usd 响应头写明本次调用的费用。

参数

根据实时目录生成：这里列出的每个值 API 都接受。

参数
名称	类型	可用值	默认值	对价格的影响
`model`必填执行调用的模型。	字符串	kokoro · chatterbox-turbo · chatterbox-multilingual · orpheus-3b	—	—
`input`必填要朗读的文本。	字符串	1–4,096	—	按字符计费
`voice`可选朗读文本的声音。	字符串	—	—	—
`response_format`可选音频文件格式。	字符串	mp3 · wav · opus	—	—

错误及解决方法

401缺少密钥或密钥错误
用 Authorization: Bearer 请求头发送控制台中的密钥。
402余额不足
在账单页面充值，然后重新发送同一请求。
400有值不被接受
查看 error.message，它会指出字段。请使用参数表中的值。
429请求过多
等几秒再试，每次遇到 429 都等得更久一些。

把 Opennan 添加到你的 AI 应用

安装一次，你的 AI 就能使用 Opennan 的全部工具：视频、图片、聊天、语音、音乐、音效、3D、字幕和配音。选择你的应用，按步骤操作。

MCP 服务器https://api.opennan.com/v1/mcp

适用于 Codex CLI、Codex 应用和 Codex IDE 扩展：它们共用 ~/.codex/config.toml。如果应用或 IDE 读不到 OPENNAN_KEY，请用写入密钥的 config.toml 方式。Codex 每次调用工具前会询问，批准即可继续。

获取 API 密钥
在控制台创建密钥。密钥以 sk- 开头，与网站共用同一余额。
创建密钥

把密钥保存为 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-..."

3
安装 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-..." }

4
确认列表里有 opennan
```
codex mcp list
```
重启 Codex，然后让它做任何事
“做一段 5 秒的霓虹街道下雨视频，再配一首歌和一张海报图。”

把 sk-... 换成你自己的密钥并妥善保管：拿到它的人可以花你的余额。没有密钥时应用也能列出工具，但生成内容需要密钥。

在 AI 智能体中使用

把 Opennan MCP 服务器加到你的智能体中，然后调用此工具。

工具: generate_speech
示例参数: { "model": "kokoro", "input": "你好！这段语音只用一次 API 调用就生成了。", "voice": "heart" }