Cloud API keys
Applies to WhisprDesk 1.9.0 · Updated 2026-11-16
WhisprDesk uses your own API key for cloud transcription. Your audio is sent directly from your Mac to the provider you choose, and the provider bills your account. If you would rather keep your voice on your Mac, use local transcription instead.
Before you start
Open the WhisprDesk app: click its icon in the Dock, or open it from your Applications folder. The WhisprDesk window opens on the Transcripts tab. If WhisprDesk is running but you don't see its window, click the WhisprDesk icon in the menu bar at the top right of your screen and choose Open WhisprDesk.
Transcription keys are entered in Models > Speech to text. AI text cleanup has its own key, entered in Models > AI cleanup. Agent Mode uses the keys you enter in Models > Agent.
Supported providers
| Provider | Models in the app | Get a key |
|---|---|---|
| OpenAI | OpenAI's speech-to-text models (the list is in the app) | platform.openai.com/api-keys |
| Groq | Whisper Large v3, Whisper Large v3 Turbo | console.groq.com/keys |
| Mistral | Voxtral Mini | console.mistral.ai/api-keys |
| Custom | Any model name your endpoint accepts | Your own service |
Add a key
Where: WhisprDesk > Models > Speech to text > Cloud (your key)
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the Models tab at the top of the window, then click Speech to text.
- Click the Cloud (your key) tab.
- Click a provider tab: OpenAI, Groq, or Mistral.
- Paste your key into the API Key field and click Save. If you do not have one, click Get key. It opens the provider's website in your browser, where you sign in and create a key, then copy it back here.
- Click a model. It shows Selected. Models can't be chosen until a key is entered.
- Click Use this model.
- Check the banner at the top of the page. Under Now transcribing with it should show the model and via the provider.
Entering a key does not switch you to cloud by itself. Only Use this model changes the model you use. If you later click Use this model on a downloaded local model, WhisprDesk switches to local. Your key stays saved for when you switch back.
Custom endpoint
Where: WhisprDesk > Models > Speech to text > Cloud (your key) > Custom
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the Models tab at the top of the window, then click Speech to text.
- Click the Cloud (your key) tab, then the Custom tab.
- Enter your service's Endpoint URL.
- Enter an API Key if your service needs one (it is optional).
- Enter the Model name your service expects.
- Click Use this model. It shows In use when it is active.
Your endpoint must accept audio file uploads for transcription in the same request style as the built-in providers.
The endpoint must use https. Plain http is accepted only for a server on your own Mac or your local network (for example http://localhost:… or a 192.168.… address).
A custom endpoint only ever receives the key you enter for it. WhisprDesk never sends your OpenAI, Groq or Mistral key to a custom endpoint, so if your service needs one of those keys, paste it into the custom endpoint's API Key field.
How keys are stored
API keys are stored on your Mac and encrypted using macOS secure storage (Keychain). They are never sent to us. Each key is only sent to its own provider when you use it. Reset app data (gear button > System) deletes your saved keys.
What is sent in cloud mode
- Your recording, each time you dictate.
- Your Vocabulary words, if you have added any. They help the provider recognize names and terms.
- Audio files you transcribe on the Transcribe a file tab, up to 25 MB per file.
The provider's own privacy policy and terms apply to what you send them.
Using the same key for AI cleanup
Where: WhisprDesk > Models > AI cleanup
AI cleanup has its own provider and key settings, so you enter that key separately:
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the Models tab at the top of the window, then click AI cleanup.
- Follow AI cleanup. After you click a model, click Use this model to switch to it.
Agent Mode works the same way in Models > Agent: open the WhisprDesk app, click the Models tab at the top of the window, click Agent, turn on Enable Agent Mode, then pick a provider, enter its key, click a model, and click Use this model. Claude models there are Claude Sonnet 5.5, Claude Haiku 5.5, and Claude Opus 5.5; Groq offers GPT-OSS 120B and GPT-OSS 20B.