OpenAI 兼容 API（TTS）

本页用于配置 OpenAI 或提供 OpenAI 兼容语音接口的服务商。完成配置后，在“发声”中选择模型和音色。

::: info 为什么选择 OpenAI 兼容 TTS？ 如果你的语音服务商明确提供 OpenAI 兼容的语音合成接口，可以用同一种配置方式接入 AIRI。仅 API 地址以 /v1 结尾或密钥以 sk- 开头，不能保证服务兼容。 :::

第一步：获取 API Key

1. 登录所选服务商的管理控制台。
2. 在 API 密钥或开发者设置页面创建 API Key。
3. 复制密钥并妥善保存。

::: warning API Key 安全 不要将 API Key 提交到仓库、放入截图，或发送给他人。密钥泄露后，请立即在服务商控制台撤销它并创建新密钥。 :::

第二步：在 AIRI 中配置

1. 打开 设置 → 服务商 → 语音合成 → OpenAI 兼容 API。
2. 填写 API Key 和要使用的 TTS 模型 ID。
3. 使用 OpenAI 官方服务时，保留默认 Base URL：https://api.openai.com/v1/；使用兼容服务时，填写服务商文档提供的 API 根地址。
4. 根据需要调整语速。

3. 配置校验

1. 在“发声”中选择已配置的服务商、模型和音色。
2. 输入一段测试文本并点击测试。
3. 能正常播放语音即表示配置成功；如果显示错误，请根据错误信息检查凭据、模型 ID 与 Base URL。

排查

没有声音时，先确认已选择该服务商支持的模型和音色。使用兼容服务时，请确认其明确支持 OpenAI 语音合成接口。