使用 Mistral 进行文本转语音

本指南介绍如何在 Open WebUI 中使用 Mistral 的文本转语音 (TTS) API。

正在寻找 STT？

请参阅配套指南：使用 Mistral Voxtral 进行语音转文本

要求

• Mistral API Key
• 已安装并运行的 Open WebUI

快速设置 (UI)

1. 点击您的头像图标（左下角）
2. 选择 管理员面板 (Admin Panel)
3. 点击 设置 (Settings) -> 音频 (Audio) 选项卡
4. 配置以下内容：

设置	值
文本转语音引擎 (Text-to-Speech Engine)	MistralAI
API Base URL	https://api.mistral.ai/v1
API Key	您的 Mistral API Key
TTS 模型 (TTS Model)	mistral-tts-latest（或留空以使用默认模型）
TTS 音色 (TTS Voice)	从可用音色中选择

5. 点击保存

可用模型

模型	描述
mistral-tts-latest	用于 Mistral TTS 的默认模型

信息

如果 AUDIO_TTS_MODEL 为空，Open WebUI 将默认为 Mistral TTS 使用 mistral-tts-latest。

环境变量设置

如果您更倾向于通过环境变量进行配置：

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    environment:
      - AUDIO_TTS_ENGINE=mistral
      - AUDIO_TTS_MISTRAL_API_KEY=your-mistral-api-key
      - AUDIO_TTS_MISTRAL_API_BASE_URL=https://api.mistral.ai/v1
      - AUDIO_TTS_MODEL=mistral-tts-latest
      - AUDIO_TTS_VOICE=<voice-id>
    # ... 其他配置

所有 Mistral TTS 环境变量

变量	描述	默认值
AUDIO_TTS_ENGINE	设置为 mistral	空（仅使用浏览器内置的 TTS）
AUDIO_TTS_MISTRAL_API_KEY	您的 Mistral API Key	空
AUDIO_TTS_MISTRAL_API_BASE_URL	Mistral API Base URL	https://api.mistral.ai/v1
AUDIO_TTS_MODEL	TTS 模型	mistral-tts-latest（Mistral 引擎的实际默认模型）
AUDIO_TTS_VOICE	音色 ID	空

选择音色

Open WebUI 会查询已配置 of Mistral 端点以获取可用的音色，并将它们显示在 TTS 音色 选择器中。

如果没有列出音色：

• 确认您的 API Key 有效
• 验证 Open WebUI 服务器/容器是否可以访问 API Base URL
• 查看日志以排查 /audio/voices 请求错误

测试 TTS

1. 开始新聊天
2. 向任何模型发送一条消息
3. 点击 AI 回复上的喇叭图标以听取朗读内容

故障排除

“Mistral API key is required for Mistral TTS” 错误

1. 确认已设置 AUDIO_TTS_MISTRAL_API_KEY（或在管理员音频设置中已输入）
2. 保存设置并重试

下拉菜单中未显示音色

1. 验证 Open WebUI 到 AUDIO_TTS_MISTRAL_API_BASE_URL 的网络连接
2. 检查 Open WebUI 日志中的 Mistral 音色列表错误
3. 确认您的 API Key 拥有访问 Mistral 音频 API 的权限

TTS 请求失败

1. 验证 AUDIO_TTS_ENGINE=mistral
2. 尝试将模型留空（将默认使用 mistral-tts-latest）
3. 从获取到的列表中尝试使用另一个音色 ID

有关更广泛的音频调试，请参阅 音频故障排除指南。