跳到主要内容

在 OPL 数据空间中使用 Mistral 做文字转语音

本指南介绍如何把 Mistral 的 TTS API 用作 OPL 数据空间的语音合成引擎。

需要 STT？

对应说明见 Using Mistral Voxtral for Speech-to-Text。

前提​

  • 一个可用的 Mistral API Key
  • 正在运行的 OPL 数据空间

快速配置（UI）​

  1. 点击左下角头像
  2. 进入 管理员面板
  3. 打开 设置 → 语音
  4. 设置：
设置项值
Text-to-Speech EngineMistralAI
API Base URLhttps://api.mistral.ai/v1
API Key你的 Mistral API Key
TTS Modelmistral-tts-latest，或留空
TTS Voice从可用列表中选择
  1. 点击 Save

模型​

模型说明
mistral-tts-latestMistral TTS 默认模型

如果 AUDIO_TTS_MODEL 为空， OPL 数据空间对 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>

常用变量​

变量说明默认值
AUDIO_TTS_ENGINE设为 mistral空
AUDIO_TTS_MISTRAL_API_KEYMistral API Key空
AUDIO_TTS_MISTRAL_API_BASE_URLMistral API 地址https://api.mistral.ai/v1
AUDIO_TTS_MODELTTS 模型mistral-tts-latest
AUDIO_TTS_VOICE语音 ID空

声音选择​

OPL 数据空间会向配置好的 Mistral 端点请求可用 voices，并在 TTS Voice 选择器里展示。

如果下拉没有声音：

  • 确认 API Key 有效
  • 确认 OPL 数据空间所在主机 / 容器能访问该 Mistral 端点
  • 检查日志中 /audio/voices 请求是否报错

测试方式​

  1. 发起新聊天
  2. 让模型生成一条回复
  3. 点击回复旁的扬声器图标试听

故障排查​

“Mistral API key is required for Mistral TTS”​

  1. 检查是否设置了 AUDIO_TTS_MISTRAL_API_KEY
  2. 保存后重试

没有 voices​

  1. 检查网络连通性
  2. 查看 OPL 数据空间日志中 Mistral 语音列表请求
  3. 确认 Key 具备音频 API 权限

TTS 请求失败​

  1. 确认 AUDIO_TTS_ENGINE=mistral
  2. 模型留空测试默认行为
  3. 换一个 voice ID 再试

更多问题见 音频排障指南。