跳到主要内容

API 服务器

Neiroha 暴露一个本地 HTTP 服务器，供外部工具通过 OpenAI 兼容接口调用 TTS。

启动服务器​

打开：

设置 → API 服务器（API Server）

默认配置：

配置默认值
绑定地址127.0.0.1
端口8976
接口密钥（API Key）空
跨域来源（CORS origins）空
限流60 req/min/IP
最大请求体1048576 字节

默认只允许本机访问。需要局域网访问时，再将绑定地址改为 0.0.0.0，并配置接口密钥（API Key）。

配置接口密钥后，客户端需要发送任一鉴权头：

Authorization: Bearer <key>

或：

X-API-Key: <key>

如果接口密钥为空，请求示例中的鉴权头可以省略。

接口列表​

方法路径说明
POST/v1/audio/speech语音合成，OpenAI 兼容
GET/v1/audio/voices列出激活语音库中的声音
GET/v1/models将激活语音库列为模型
GET/speakersSillyTavern 兼容说话人列表
GET/health健康检查

完整字段和错误码见 中文 API 参考。

请求示例​

curl http://localhost:8976/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <key>" \
  -d '{
    "model": "Default Bank",
    "voice": "Default Voice",
    "input": "你好，世界！",
    "response_format": "wav",
    "speed": 1.0
  }' \
  --output hello.wav

语音库作为模型​

API 以语音库作为 model 抽象层：

  • 激活语音库会出现在 /v1/models。
  • 语音库名称可作为 POST /v1/audio/speech 的 model 值。
  • /v1/audio/voices 和 /speakers 的声音限定在激活语音库范围内。

这让 OpenAI 兼容客户端可以用“模型”选择不同的角色集合。