From dc2a51a21ee66d89e8418584b613a4c9bca07710 Mon Sep 17 00:00:00 2001 From: yoyoismee <14046637+yoyoismee@users.noreply.github.com> Date: Sat, 24 Oct 2026 18:12:00 +0700 Subject: [PATCH] docs: note OpenAI's speech model shutdown dates and correct the STT model default OpenAI removes tts-1, tts-1-hd and gpt-4o-mini-tts from its API on 2027-01-06, and whisper-1, gpt-4o-transcribe, gpt-4o-mini-transcribe and gpt-4o-transcribe-diarize on 2027-02-26. Add a caution to each OpenAI page. The TTS replacement, gpt-realtime-2.1-mini, is not supported on /audio/speech, so the TTS caution points to the OpenAI Realtime engine. AUDIO_STT_MODEL defaults to an empty string in config.py, and the OpenAI engine sends it as is. The STT page now says so, instead of saying that whisper-1 is used when it is unset, and the env table matches the environment variable reference. Add a troubleshooting step to both pages: when the API Base URL points to another OpenAI-compatible service, use that service's model and voice IDs instead of the OpenAI defaults. Co-Authored-By: Claude Opus 5.5 --- .../audio/speech-to-text/openai-stt-integration.md | 11 ++++++++--- .../audio/text-to-speech/openai-tts-integration.md | 5 +++++ 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/features/chat-conversations/audio/speech-to-text/openai-stt-integration.md b/docs/features/chat-conversations/audio/speech-to-text/openai-stt-integration.md index 1b92b39a4a..9a8b6a9a06 100644 --- a/docs/features/chat-conversations/audio/speech-to-text/openai-stt-integration.md +++ b/docs/features/chat-conversations/audio/speech-to-text/openai-stt-integration.md @@ -39,10 +39,14 @@ See the companion guide: [Using OpenAI for Text-to-Speech](/features/chat-conver |-------|-------------| | `gpt-transcribe` | Current OpenAI transcription model (recommended) — roughly half the word error rate of `whisper-1` | | `gpt-live-transcribe` | Low-latency streaming transcription | -| `whisper-1` | Legacy Whisper large-v2 model, still available | +| `whisper-1` | Legacy Whisper large-v2 model, retiring on 2027-02-26 | :::info -OpenAI recommends `gpt-transcribe` for new setups; `whisper-1` remains available and is what Open WebUI uses when `AUDIO_STT_MODEL` is unset. For fully local transcription, use Local Whisper (built into Open WebUI) or another provider such as Deepgram. +OpenAI recommends `gpt-transcribe` for new setups. `AUDIO_STT_MODEL` is empty by default, so set the model explicitly. For fully local transcription, use Local Whisper (built into Open WebUI) or another provider such as Deepgram. +::: + +:::caution OpenAI is retiring older transcription models +OpenAI is removing `whisper-1`, `gpt-4o-transcribe`, `gpt-4o-mini-transcribe` and `gpt-4o-transcribe-diarize` from its API on 2027-02-26. If **STT Model** is set to one of them, switch to `gpt-transcribe` before then. See [OpenAI's deprecations page](https://developers.openai.com/api/docs/deprecations#2026-08-26-transcription-models) for details. ::: ## Environment Variables Setup @@ -68,7 +72,7 @@ services: | `AUDIO_STT_ENGINE` | Set to `openai` | empty (uses local Whisper) | | `AUDIO_STT_OPENAI_API_BASE_URL` | OpenAI API base URL | `https://api.openai.com/v1` | | `AUDIO_STT_OPENAI_API_KEY` | Your OpenAI API key | empty | -| `AUDIO_STT_MODEL` | STT model | `gpt-transcribe` | +| `AUDIO_STT_MODEL` | STT model | empty | | `AUDIO_STT_SUPPORTED_CONTENT_TYPES` | Allowed audio MIME types | `audio/*,video/webm` | ### Supported Audio Formats @@ -122,6 +126,7 @@ Choose **Local Whisper** if: 1. Check your OpenAI API key is valid 2. Verify the API Base URL is correct 3. Check container logs for error messages +4. If the API Base URL points to another OpenAI-compatible service, set **STT Model** to a model ID that service supports ### Language Issues diff --git a/docs/features/chat-conversations/audio/text-to-speech/openai-tts-integration.md b/docs/features/chat-conversations/audio/text-to-speech/openai-tts-integration.md index a9270c3048..1a746868f4 100644 --- a/docs/features/chat-conversations/audio/text-to-speech/openai-tts-integration.md +++ b/docs/features/chat-conversations/audio/text-to-speech/openai-tts-integration.md @@ -40,6 +40,10 @@ See the companion guide: [Using OpenAI for Speech-to-Text](/features/chat-conver | `tts-1` | Standard quality, lower latency | Real-time applications, faster responses | | `tts-1-hd` | Higher quality audio | Pre-recorded content, premium audio quality | +:::caution OpenAI is retiring these models +OpenAI is removing `tts-1`, `tts-1-hd` and `gpt-4o-mini-tts` from its API on 2027-01-06. Its recommended replacement, `gpt-realtime-2.1-mini`, is not supported on the `/audio/speech` endpoint that the `OpenAI` engine calls, so changing the **TTS Model** is not enough. To keep using OpenAI for speech, switch to the [OpenAI Realtime engine](#using-the-openai-realtime-engine). See [OpenAI's deprecations page](https://developers.openai.com/api/docs/deprecations#2026-10-01-text-to-speech-models) for details. +::: + ## Available Voices OpenAI provides 6 built-in voices: @@ -230,6 +234,7 @@ When reading long responses, Open WebUI can split text into chunks before sendin 1. Check your OpenAI API key is valid and has Audio API access 2. Verify the API Base URL is correct (`https://api.openai.com/v1`) 3. Check browser console (F12) for errors +4. If the API Base URL points to another OpenAI-compatible service, replace the default `tts-1` and `alloy` with a **TTS Model** and **TTS Voice** that service supports ### Audio Quality Issues