Skip to main content

Documentation Index

Fetch the complete documentation index at: https://vowen.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Vowen uses AI in two ways:
  1. AI Enhancement: polishes your transcriptions (grammar, formatting)
  2. Command Mode: processes voice instructions with full AI capabilities
Both require connecting an AI provider with your own API key. Vowen never charges you for AI usage; you pay your provider directly (many have generous free tiers).

​
Supported Providers

Vowen supports 11 providers. Click any provider name in the table to go directly to the page where you generate an API key. AI Provider list in Vowen settings
ProviderFree TierBest ForRecommended Model
OpenAINo (paid)Best overall qualityGPT-5.4 Nano
AnthropicNo (paid)Nuanced writingClaude Haiku 4.5
GroqYes (generous)Fast responses, free usageLlama 3.3 70B Versatile
GoogleYes (generous)Image/video context, free usageGemini 2.5 Flash Lite
DeepSeekYes (limited)Budget-friendlyDeepSeek Chat
OpenRouterVariesAccess to 700+ modelsGemini 2.0 Flash (free)
StraicoVariesMulti-model accessAmazon Nova Micro
AzureNo (paid)Enterprise complianceGPT-4.1 Nano
CerebrasYes (limited)Ultra-fast inferenceLlama 3.1 8B
AWS BedrockNo (paid)Enterprise, regionalAmazon Nova Lite
Custom APIVariesSelf-hosted or OpenAI-compatible endpointsYour choice

​
Setup Steps

1

Open AI Settings

Go to Settings > AI Setup.
2

Click Setup on a provider

Each provider card has a Setup button. Click it to open the configuration popup.
3

Paste your API key

Enter the key from the provider’s dashboard. The popup also has a “See how to retrieve API key here” link that opens the provider’s API key page in your browser.AI provider setup popup
Your API key is encrypted at rest using your operating system’s secure storage (Keychain on macOS, DPAPI on Windows).
4

Pick a default model

Choose from the dropdown. The recommended model is pre-selected. Different models offer different speed, quality, and cost trade-offs.
5

Click Connect

Vowen verifies the key and saves it. A green check on the provider card means it’s the active connection.

​
Custom API setup

The Custom API provider works with any OpenAI-compatible endpoint (Ollama, LM Studio, vLLM, self-hosted models, internal gateways). Its setup popup has one extra field. Custom API setup popup
  • API Key (optional): leave blank if your endpoint doesn’t require auth.
  • Base URL (required): point at your endpoint, e.g., http://localhost:11434/v1 for Ollama.
  • Default model: the model identifier your endpoint expects (e.g., gpt-4o-mini, llama3.1).
Pro tip: Want fully local AI? Install Ollama, run a model like llama3.1, point Base URL at http://localhost:11434/v1 and leave the API key blank. No data leaves your machine.

​
Disconnecting a provider

Open the Setup popup on a connected provider (its card has a gear icon and a green check). A Disconnect button appears in the bottom right. Click it to remove the key and clear the active connection. Connected provider popup with Disconnect button

​
Where to Get API Keys

Each card opens the provider’s developer console where you sign up and generate a key.

​
Free tier

Groq

Generous free tier. Ideal for daily dictation.

Google

Generous free tier with multimodal support.

Cerebras

Free tier with ultra-fast inference.

DeepSeek

Free tier with limited monthly tokens.

OpenAI

Requires payment method. Top overall quality.

Anthropic

Requires funded credits. Starter credits on signup.

Azure

Requires Azure subscription. Enterprise compliance.

AWS Bedrock

Requires AWS account. Enable models, create key.
Pro tip: Most paid providers let you cap monthly spend per API key. Set it to your daily-use ceiling so a runaway loop can’t drain your wallet.

​
Multi-provider gateways

OpenRouter

One key, 700+ models. Several free options.

Straico

One key, multiple providers. Prepaid credits.

​
Self-hosted

Custom API

Point Vowen at any OpenAI-compatible endpoint. Works with Ollama, LM Studio, vLLM, and self-hosted models.

​
Switching Providers

Configuring more than one provider is recommended. AI APIs occasionally go down or hit rate limits, and having a second provider connected means you can switch in seconds instead of scrambling to set up a new key mid-outage.
  • The active provider shows a green check on its card
  • Click any configured provider to make it active
  • API keys stay saved, so no need to re-enter them when switching
  • If your active provider has an outage, switching to a configured backup is one click away
Set up Groq plus Google as a backup. Both have generous free tiers, so a redundant configuration costs nothing.

​
Model Selection

After connecting a provider, click the gear icon on the provider card to select which model to use. Models vary in:
  • Speed: how quickly responses come back
  • Quality: how well it follows instructions and formats text
  • Cost: per-token pricing (relevant for paid providers)
For AI Enhancement (light cleanup), even the smallest/cheapest models work well. For Command Mode (complex instructions), use larger models.
Pro tip: Configuring one beefy model for both Enhancement and Command Mode wastes tokens on light cleanup. Run a small/cheap model as your active default and use a Tone to bump it up for Command Mode contexts.

​
Rate Limits

If you hit rate limits (especially on free tiers):
  • Switch between providers (e.g., alternate between Groq and Gemini)
  • Use a larger model that has higher limits
  • Wait a few minutes for limits to reset
  • Consider upgrading to a paid tier for heavy usage

​
Security

Your API keys are:
  • Encrypted at rest using your OS’s secure keystore (Keychain or DPAPI)
  • Never sent to Vowen servers, only to your selected AI provider
  • Stored locally on your machine, never on our infrastructure
Pro tip: Generate a separate API key just for Vowen. If it ever leaks (synced screenshot, posted env file), revoke just that one without breaking ChatGPT, Cursor, or anything else on the same account.