桌面版支持开启「本地 API 服务」，让脚本、自动化工具或 AI 助手（MCP）直接调用语音合成。

开启方式

1. 打开应用，进入 设置 → 本地 API 服务
2. 打开开关（默认关闭）
3. 如需修改端口，输入新端口后点击「应用」，默认端口为 23456，可用范围 1024–65535

服务仅监听 127.0.0.1，不会暴露到局域网；会拒绝浏览器跨站请求。 当前没有鉴权，本机上的其他程序都可以调用，请仅在可信环境中开启。

HTTP 接口

以下示例均以默认端口 23456 为例。

使用 Edge 在线语音

curl -X POST http://127.0.0.1:23456/v1/tts \
  -H 'Content-Type: application/json' \
  -d '{"text":"你好，世界","voice":"zh-CN-XiaoxiaoNeural"}' \
  -o speech.mp3

指定本地 AI 模型

先通过 GET /v1/models 获取已安装模型的 id，再通过 model 指定：

curl -X POST http://127.0.0.1:23456/v1/tts \
  -H 'Content-Type: application/json' \
  -d '{"text":"你好","model":"模型ID","speaker":"zf_xiaobei","language":"zh"}' \
  -o speech.wav

请求参数

通过 API 生成的语音同样会记录到应用的「历史」中。

返回

• 成功：默认返回音频二进制（audio/mpeg 或 audio/wav）；format 为 json 时返回 success、audioPath、duration
• 失败：返回 JSON，包含 success: false 和 error

MCP 接入

同一个服务提供 MCP 端点（Streamable HTTP，无状态），地址为 http://127.0.0.1:23456/mcp。

Claude Code：

claude mcp add --transport http speak-text http://127.0.0.1:23456/mcp

其他支持 HTTP 传输的 MCP 客户端，使用如下配置：

{
  "mcpServers": {
    "speak-text": {
      "type": "http",
      "url": "http://127.0.0.1:23456/mcp"
    }
  }
}

提供的工具：

注意事项

• 本地 AI 模型一次只能生成一条，引擎忙碌或模型未安装时会返回错误
• 暂不支持需要参考音频的克隆音色模型
• 端口被占用时，设置页会提示启动失败，更换端口即可
• 需要桌面版 v1.0.6 及以上版本