OpenAI · easiest setup
OpenAI
Parleq can call OpenAI's API directly at api.openai.com using your own API key. This gives you access to GPT-4o and GPT-4.1 for cleanup, plus the o1 / o3 / o4-mini reasoning models for context-aware reference turns. If you already have an OpenAI API key for other tools, setup takes about two minutes.
At a glance
- Auth: One API key (starts with
sk-) pasted from platform.openai.com. - Default model:
gpt-4o-mini— fast, cheap, capable enough for cleanup. - Setup time: ~2 minutes if you already have an API key.
- Compliance note: Calls go to OpenAI's consumer API under your account's terms. If your organization needs Microsoft's enterprise contract or specific data-residency controls, use Azure OpenAI instead — same models on Microsoft's infrastructure.
Setup
- 1.
Get an API key.
Go to platform.openai.com → API keys, sign in, and click Create new secret key. The key starts with
sk-. Copy it — it's only shown once.Your account needs a positive credit balance or an active paid plan. API keys from a free trial account with no credits will return
429 insufficient_quotaon every call. - 2.
Paste it into Parleq's setup wizard.
On first launch the wizard will prompt for a provider. Pick OpenAI, paste the key, click Continue, then Finish & Restart.
Already past the wizard? Open Settings… → Cleanup provider, switch to OpenAI, paste the key, and save. Switching the active provider requires restarting Parleq — Settings surfaces a Restart Now banner when this is needed. Once OpenAI is selected and Parleq has restarted, rotating the API key takes effect on the next dictation without restart, because the key is re-read from the Keychain per request.
- 3.
Test a dictation.
Hold right Option, say a sentence, release. The overlay should show your raw words being replaced by a punctuated, capitalized version within ~600–800 ms.
Choosing a model
gpt-4o-mini is the default and covers almost every dictation use case — fast, cheap, and well-calibrated for short cleanup tasks. Open Settings → Cleanup to pick from the model list or enter a custom identifier.
Standard models (text and vision-capable are marked 👁):
gpt-4o-mini— fastest (cleanup default) 👁gpt-4o— highest quality 👁gpt-4.1— current 👁gpt-4.1-mini— current, cheaper 👁gpt-4.1-nano— text-only, smallest
Reasoning models — slower, useful for complex reference-aware turns:
o1— reasoning 👁o1-mini— reasoning, text-onlyo3— reasoning 👁o3-mini— reasoning, text-onlyo4-mini— reasoning 👁
Reasoning models send a different request shape (no temperature, max_completion_tokens instead of max_tokens). Parleq detects reasoning models automatically from the model name — no manual family switch needed, unlike Azure.
Pricing
Per-token† at OpenAI's published rates. Cleanup prompts are short (a few hundred input tokens, a few hundred output tokens), so a typical day of personal dictation runs to single-digit cents on gpt-4o-mini. Settings → Usage tracks per-call token counts and rolling cost estimates.
† Third-party pricing, free tiers, and quotas are set by the providers — AWS, Google, Microsoft, Okta, and others change them without notice. Cost statements here were accurate when written; verify current rates on the provider's pricing page before you build.
Compliance notes
Calls go to OpenAI's API under your account's consumer or pay-as-you-go terms. If your organization needs Microsoft's enterprise data-privacy commitments or Azure's regional deployment guarantees, use Azure OpenAI — the same models on Microsoft infrastructure.
Audio never reaches OpenAI. Only the text transcript output by Parleq's on-device speech model is sent.
Troubleshooting
401 Unauthorized on first dictation
The key is invalid or has been revoked. Re-copy it from platform.openai.com → API keys and paste it into Settings again (make sure there's no leading or trailing whitespace).
429 insufficient_quota
Your account has no remaining credit. Add a payment method and top up your balance at platform.openai.com → Billing.
404 model_not_found
The model ID isn't available on your account tier, or the name is misspelled. Check the exact ID at platform.openai.com → Models and confirm your account has access to it (some models require org-level access requests).