Documentation Index
Fetch the complete documentation index at: https://docs.vowen.ai/llms.txt
Use this file to discover all available pages before exploring further.
API Key Not Working
Symptoms
- “Connection failed” when verifying
- AI enhancement does nothing
- Error messages mentioning authentication
Fix
- Double-check your API key — copy it fresh from the provider’s dashboard
- Ensure there are no extra spaces before or after the key
- Verify your account is active on the provider’s website
- Some providers require a payment method on file even for free tiers
AI Enhancement Is Slow
Symptoms
- Long delay between releasing shortcut and text appearing
- Works but takes 5+ seconds
Possible Causes & Fixes
| Cause | Fix |
|---|---|
| Slow AI model | Switch to a faster model (Gemini Flash Lite, Groq Llama 8B) |
| Provider overloaded | Try a different provider temporarily |
| Long transcription | Shorter dictations process faster |
| Network latency | Check your internet connection |
Rate Limit Errors
Symptoms
- Works for a few transcriptions then stops
- Error mentioning “rate limit” or “quota exceeded”
Fix
- Wait a few minutes — most rate limits reset within 1-5 minutes
- Switch providers — alternate between Groq and Gemini (both free)
- Reduce usage — disable AI enhancement for quick, informal dictations
- Upgrade — most providers offer higher limits on paid plans
Command Mode Returns Errors
Symptoms
- Command Mode transcribes but doesn’t produce AI output
- Error messages or garbled results
Fix
- Ensure your AI model has 6B+ parameters (small models can’t follow instructions)
- Verify Command Mode is enabled in AI settings
- Check that your shortcut isn’t releasing too quickly (hold for the full duration of your command)
- Try a known-good model like GPT-4o Mini or Gemini Flash
Garbled Characters in Output
Symptoms
- Characters like
?appear in the enhanced text - Encoding issues after AI processing
Possible Causes
- Some third-party API proxies (like PacKYAPI) have encoding issues with streaming
- Non-UTF-8 characters in the AI response
Fix
- Try disabling streaming (if your provider supports a non-streaming option)
- Switch to a direct provider (OpenAI, Anthropic, Groq) instead of a proxy
- Report the issue with your specific provider configuration on our Discord
AI Not Following Instructions
Symptoms
- Custom instructions are ignored
- AI produces unexpected formatting
Fix
- Keep instructions simple and specific
- Use a more capable model (GPT-4, Claude, Gemini Pro)
- Smaller models (7B-8B parameters) may ignore complex instructions
- Check that your instructions aren’t contradicting each other
- Try rephrasing. Sometimes different wording works better
Output Is Being Rewritten or Paraphrased
Symptoms
- AI Enhancement rephrases your sentences instead of just cleaning them up
- Your wording is replaced with synonyms or restructured
Fix
Switch to a model better at instruction following (GPT-4, Claude, Gemini Pro). Smaller open-weight models occasionally rewrite despite the system prompt forbidding it. If the issue persists, add a custom instruction like “Do not rewrite or rephrase. Only fix errors.”AI Adds Words You Did Not Say
Symptoms
- The enhanced output contains phrases, facts, or information you never spoke
- Hallucinated content appears in transcriptions