How do I use my own AI key in Clickmax?
In Settings > Accounts center > AI keys, add the API key from your AI provider and link that key to one of the Clickmax models (Max Basic, Max Pro, Transcription or Image). From then on, the platform AI that uses that model runs on your key, and the provider bills the calls to your account. A model with no linked key keeps running on Clickmax AI.
Before you start
- Permission: workspace keys and models show for people with the View permission of the Chaves de IA resource. Adding, renaming, testing, removing and linking models needs the Manage permission of the same resource. Without Manage, the Workspace tab is read-only. The My keys tab works for any workspace member.
- Supported providers: OpenRouter, OpenAI, Anthropic, Google Gemini, Groq, Mistral, DeepSeek, xAI and Other provider, which is your own OpenAI-compatible API URL.
- The key is stored encrypted and never shown again: the screen shows only its last 4 characters.
The screen has two tabs, each with its key count: Workspace, with the keys that apply to the whole workspace, and My keys, with your personal keys. In each tab, the Keys block lists one key per row (name and provider, end of the key, last test, what uses the key and its status) and the Models block lists one Clickmax model per row.
Add a key
- Open Settings > Accounts center > AI keys.
- Open the Workspace tab for a workspace key, or My keys for a key of your own, and click Add key at the top of the screen. The key is created in the open tab.
- Choose the provider and click Continue. The note below the list shows which providers cover Audio transcription and Image generation; the others cover text only. On the next screen, Back switches the provider.
- Paste the key in API key. The hint below the field shows how that provider's keys start, and the field warns you when the key doesn't start that way.
- Optionally, give it a Name to recognize it in the list.
- For Other provider, also fill in the API URL (only
https://, with a public domain) and, if your server expects the key in its own header, the Header name. Left blank, the key is sent asAuthorization: Bearer. - Click Add key. Clickmax checks the key with the provider before saving it.
The key shows in the list with one of these states:
- Active: the provider confirmed the key.
- Not verified: the provider didn't confirm or reject it (this happens with restricted keys that can't list models). It's tested when you link a model to it.
- Rejected: the provider rejected the key. Below the row, See provider response shows what the provider answered. Fix the key in the provider's account and use Test again in the key's menu.
Link a model to a key
Each Clickmax model serves one kind of platform AI:
- Max Basic: meeting report, questions and memory for meetings without an agent; call and playbook copilot; live chat suggestions, summaries and classification; contact X-ray; contact screening at booking and the AI SDR classification; proposals; contact import; Studio content plan; producer tone suggestion; comment replies; webinar and call reports; reading images attached to Max and improving requests to Max. To read images attached to Max, choose a model that understands images.
- Max Pro: brandbook chapters and the funnel A/B test challenger.
- Transcription: live chat audio, calls, playbook simulator audio and voice dictation in Max.
- Image: images generated by Max, Max Design and the Studio.
- On the Models block, click Link to a key on the model's row (or Change, if it already has a key). The choice opens in a window.
- In Key, choose one of your keys. Only keys from providers that offer that model show up: not every provider offers transcription and images, and the row says which ones do when none of your keys fits.
- In Model, search and choose a model from your provider account's list. With many models, the list shows the first ones that match the search: keep typing to find another. If the model isn't in the list, type its ID and choose the Use option with the typed ID. If the provider doesn't list its models, type the Model ID as it appears in the provider's documentation.
- Click Save. Clickmax makes a test call with the key and the model, which takes a few seconds.
A linked row shows the key and the model. A row with no key keeps running on Clickmax AI.
If the test fails, nothing is saved. The window says what to do and shows the provider's response separately (for example, a model the key can't use).
If the provider rejects the key of a model that is already linked, the model's row says so: the AI of that model fails until you test the key again or link another key.
To move a model back to Clickmax AI, click Remove on its row.
My keys
Keys and models in the My keys tab apply only to what you trigger, such as regenerating a meeting report or asking a question about it. For those actions, your linked model takes precedence over the workspace's. No one else in the workspace sees your personal keys.
What runs on its own, without a person clicking (like the report generated at the end of a meeting), uses only the workspace keys.
What never runs on an added key
The Always on Clickmax AI notice at the top of the screen sums up what always runs on Clickmax AI, even with a linked key. Click See list to see all of it:
- Conversations with Max and Summaries of long conversations with Max;
- titles of conversations with Max and how Max reads the first request of a conversation;
- the meeting training script and voice;
- social media post captions;
- message variations of WhatsApp Web campaigns and friendly chats between your WhatsApp Web numbers.
When a key fails
Clickmax doesn't swap your key for the platform AI when it fails: the action stops and the screen says the AI key failed, with the Go to AI keys button. Check the key in the list (its state shows on the row, and the provider's response under See provider response), fix what's needed in the provider's account and use Test again.
The provider account is out of credits. If the message says the key's AI provider account is out of credits, the key is correct but the OpenAI or Anthropic account has no balance to pay for the calls. Waiting doesn't help: add balance on the provider's billing page and try again. The key works again on its own, without Test again. A key from an account with no balance can still show as Active in the list, because the check only lists the models, which the provider allows even without balance.
When Clickmax AI stops in your workspace
Actions whose model is linked to one of your keys don't depend on Clickmax AI: if it stops in your workspace, those actions keep working on your key. Conversations with Max always run on Clickmax AI and stop with it, even with a linked key.
Remove a key
- In the key's actions menu (the three dots at the end of the row), click Remove.
- The window lists the agents that use the key and the models linked to it. The linked models go back to Clickmax AI when the key leaves.
- If an active agent uses the key, the Remove key button stays locked. Click the agent's name to open its detail. In Model & parameters, switch Agent's key to another key from the same provider (the switch applies right away, without publishing), or pause the agent with the Live switch. Then come back.
- Click Remove key.
For keys AI agents use, see also How do I remove an API key that AI agents use?.