Skip to main content
AI Enhancement is an optional layer that sits between FluidVoice’s speech model and your active app. After the speech model transcribes your voice, the enhancement provider receives the raw transcript, applies a system prompt to clean and reformat it, and returns the polished result — which FluidVoice then types into whatever app is in focus. You can use FluidVoice without any AI Enhancement configured, but enabling it transforms rough dictation into polished prose automatically.
Use Fluid Intelligence if you want fully private AI enhancement for your dictation with no API key, no cost, and no data leaving your Mac. All processing happens on-device, including when you’re offline.For Edit Mode, and Command Mode, in AI Enhancement, you will need to set an AI provider other than Fluid Intelligence.

​
How to Add a Provider

1

Open AI Enhancement settings

Go to AI Enhancement → AI Providers
2

Select your provider

Choose the provider from the provider list (eg. OpenAI). If you want Fluid Intelligence, select it and follow the model download prompt instead.
3

Paste your API key

Enter your API key in the key field. FluidVoice stores it securely in the macOS Keychain — it is never written to disk in plaintext or included in any log. When macOS asks about keychain access, select Always allow.
4

Select a model

Pick a model from the list. FluidVoice fetches available models for the provider automatically once the key is verified.
5

Test your setup

Dictate a short sentence. The live preview overlay shows the raw transcript; the final text typed into the app reflects the AI-polished version.

​
Setting Up a Custom Provider

Custom providers let you connect FluidVoice to any OpenAI-compatible endpoint, including local model servers.
1

Add a custom provider

In AI Enhancement, under Providers, click Add Custom Provider
2

Enter the base URL

Provide the base URL of your endpoint. Examples:
3

Enter the model name

Type the model identifier exactly as your server expects it, for example llama3.2, mistral, or deepseek-r1.
4

Add an API key (if required)

Local servers like Ollama typically don’t require a key. Remote endpoints usually do. Leave the field empty if your server accepts unauthenticated requests.

​
Per-Mode Enhancement

FluidVoice applies AI Enhancement separately for Dictate mode, as compared to Command Mode, Edit mode. This means you can, for example, use Fluid Intelligence for standard dictation while using OpenAI for text rewrites — or disable enhancement entirely for one mode while keeping it active for the other. Configure each mode’s provider and model independently in Settings → AI Enhancement.

​
When Enhancement Runs

AI Enhancement runs after the speech model finishes transcribing and before the text is typed into the active app. The sequence is:
  1. You speak and release the hotkey.
  2. The speech model transcribes your audio to a raw text string.
  3. FluidVoice sends the raw transcript to your configured enhancement provider with the active system prompt.
  4. The provider returns a cleaned, formatted version.
  5. FluidVoice types the final result into the active app.
The live preview overlay shows the raw transcript as you speak, then updates to the final polished text once enhancement completes.

​
Disabling AI Enhancement

To turn off AI Enhancement entirely, go to AI Enhancement and set the provider to Off. FluidVoice falls back to Direct Dictation: the raw transcript is typed into the active app without any post-processing. You can also disable enhancement for a specific mode (Dictate or Edit) while keeping it active for the other, using the per-mode controls in the same settings panel.
API keys are stored in the macOS Keychain and are never transmitted except to the provider’s own endpoint. FluidVoice does not collect or log your API keys, transcripts, or AI responses.