Skip to main content
Voice lets your users speak to Onyx and hear its replies. A speech-to-text (STT) provider turns the user’s speech into a chat message. A text-to-speech (TTS) provider reads the Agent’s reply aloud. Both directions are off until an admin connects a provider and sets it as the default. Until then, the microphone button and read-aloud controls are hidden in chat.

Set up Voice

1

Set up a Speech to Text provider

Open Admin Panel → Voice. In Speech to Text, click Connect on a model and enter the provider credentials.Voice page in the Onyx Admin PanelSpeech to Text models
Create an API key in the OpenAI dashboard, or reuse an OpenAI key you already use for a chat model. Enter it in the API Key field.
2

Set up a Text to Speech provider

In Text to Speech, click Connect on a model and enter the provider credentials.Text to Speech models
Create an API key in the OpenAI dashboard, or reuse the key from Whisper. Enter it in the API Key field.In Default Model, choose TTS-1 (optimized for speed) or TTS-1 HD (optimized for quality).
In the Voice field, select a voice from the list or enter a voice ID. Onyx uses this voice for spoken responses.Voice selection in the provider setup dialog
3

Set the default providers

Click Set as Default on the STT model and on the TTS model you want to use. You can use one provider for speech to text and a different provider for text to speech.Set as Default on a Speech to Text modelDisconnecting a provider removes its stored credentials.

Using Voice in chat

Each user can turn on Auto-Send on Pause and Auto-Playback and set the Playback Speed under Settings > Voice.
Onyx does not store audio. Recorded speech goes to the STT provider and only the transcript is kept, as a normal chat message. Synthesized audio streams to the browser and is not saved.