MagiaCapTroubleshooting
Troubleshooting: API Keys & Errors
Fix provider configuration errors, invalid keys, and 401s.
Most errors come from missing or incorrect API keys.
Provider Not Configured
The “Transcription provider not configured” popover means no API key is set for the selected provider. Open Settings → Transcription and add the key.
Invalid Key / 401
- 1Double-check the key — copy it again from the provider's dashboard.
- 2Make sure there are no extra spaces and confirm the provider account is active.
- 3Use Test Connection in Settings to confirm.
Other Errors
LLM popover — the caption provider needs its own key in Settings → Caption Gen. Local provider errors — make sure the model is downloaded (WhisperKit) or an MLX model is selected.
After changing a key, re-run the action. You don't need to restart the app.
In-app: open MagiaCap → Help → MagiaCap Help. All docs