Cloud connection and API key errors

Invalid API key

When you test a connection, you may see messages like Invalid or unauthorized API key or Server returned [error code]. Some of these messages appear in English.

Check these:

1. The key is pasted completely and correctly. Don't leave extra spaces (the app trims spaces at the start and end).
2. The key is still valid and the provider account still has a balance or quota.
3. Key permissions (ElevenLabs). The key needs Speech to Text, Text to Speech, and Voices (read) permissions. Create the key again with all of them.
4. The Base URL is correct (for custom providers). The error Invalid base URL means the address isn't in the right format.
5. A VieNeu key is shown only once when you create it. If you lose it, create a new key.

See the per-provider instructions in Add a cloud connection with an API key.

Cloud transcription stops during a meeting

• Mac: the banner Speech recognition failed — switched to on-device recognition. Fix the engine/key; results until then may be wrong. appears. The app switches to Apple for the rest of the session. Fix the key, then start a new session.
• iPhone and iPad: if Cloud drops during a session, audio is still recorded but new text may stop appearing, and the app doesn't show a message yet. Stop, save, and record again, and check your key and network.

Out of ElevenLabs characters (read-aloud voice, Mac)

The N characters left chip appears on the Live screen when you use ElevenLabs. When the characters run out, the app reads aloud with an on-device voice instead. If you see Characters left: unavailable, the key doesn't have permission to read account information; reading aloud may still work.

Errors returned by the provider

Some provider errors are shown word for word, usually in English and in technical wording. Common ones:

• 401 / unauthorized: the key is wrong or expired.
• 402 / quota / insufficient: you're out of balance or quota.
• 429: too many requests were sent, so wait and try again.
• Network error / timeout: check your internet connection.

You can't delete a connection

A connection that's currently used as the engine for a capability can't be deleted. Switch that capability to another engine first in Settings → Intelligence & engine.

Can't solve it? Report a problem.