Your own provider keys
When a workspace runs in Your own API keys mode, your slides call the AI with keys that you get from an AI provider, and the provider bills you directly. This page shows workspace owners how to get a key, add it to SlideMind, test it and manage it.
If you would rather not manage keys, use SlideMind Credits instead: see Choosing how AI is funded.
Supported providers
Section titled “Supported providers”SlideMind supports five providers. Get an API key from the provider’s console:
| Provider | Where to get a key |
|---|---|
| OpenRouter | openrouter.ai/keys |
| OpenAI | platform.openai.com/api-keys |
| Anthropic | console.anthropic.com/settings/keys |
| Mistral | console.mistral.ai/api-keys |
| Gemini | aistudio.google.com/apikey |
OpenRouter gives access to models from many vendors with a single key, which makes it an easy place to start. Your provider may ask for a payment method or prepaid funds on your provider account before the key can answer.
Add a workspace key
Section titled “Add a workspace key”Only the workspace Owner can add, test or delete keys.
- Open Settings › AI & models. The Provider keys section appears when the workspace runs in Your own API keys mode.
- In Provider API key, choose the provider.
- In Use for, keep Workspace.
- Paste the key in Secret key.
- Select Save encrypted key. The message “Key saved and encrypted.” confirms the save, and the key appears in the list with the Untested status.
- Select Test next to the key. SlideMind asks the provider to validate it:
- “Key validated (N models).” means the key works. Its status becomes Valid.
- “Provider rejected this key.” means the provider refused it. Check that you copied the whole key and that your provider account is active, then save the key again.
SlideMind also checks the key format when you save it, and refuses a key that does not match the expected format for the chosen provider.
Key statuses
Section titled “Key statuses”| Status | Meaning |
|---|---|
| Valid | The last test succeeded. The key answers learners and loads the provider’s model catalogue. |
| Untested | The key has not passed a test: it was newly saved or replaced, or the provider rejected it. |
The list shows each key in masked form, with its scope: Workspace or Course-specific. “Encrypted server-side. Existing secrets are never returned in full.” To change a key, save a new one.
One key per provider
Section titled “One key per provider”A workspace holds one key per provider, plus one per provider for each course. Saving a new key for a provider that already has one replaces it, and the new key starts as Untested: test it again. Until you do, the slides that rely on this key cannot answer learners.
Choose the default provider
Section titled “Choose the default provider”The default provider is the one used by slides whose Provider setting is inherited. Its key carries the Default badge.
- The first workspace key that passes its test becomes the default automatically.
- To change it, select Use as default next to another Valid workspace key.
- If the default key is deleted or stops being valid, SlideMind moves the default to another valid workspace key, when there is one.
In the slide editor, a slide can also use another provider explicitly. Only providers with a Valid workspace key are offered.
Use a course-specific key
Section titled “Use a course-specific key”A course can have its own key, for example to bill a client’s courses to the client’s provider account. Slides of that course that use the same provider then use the course key instead of the workspace key.
You can add a course key in two places:
- In Settings › AI & models › Provider keys: set Use for to Course, choose the course, paste the key and select Save encrypted key.
- On the course page, in the API key card: choose the Provider, paste the Secret key and select Save key. Without a course key, the card reads “No course key — the workspace key is used.”
Then select Test, as for a workspace key. A course key that is not Valid is skipped, and the slides of the course use the workspace key.
Deleting a course key does not stop the course: “Slides of this course will fall back to the workspace key.”
Delete a key
Section titled “Delete a key”- In Settings › AI & models › Provider keys, select the delete icon next to the key.
- Read the warning, then confirm with Delete.
“Slides using this key will stop receiving model responses until another key is configured.” Before deleting a key that live courses use, add and test its replacement.
Keys and SlideMind Credits
Section titled “Keys and SlideMind Credits”In SlideMind Credits mode, the Provider keys section is hidden and every key of the workspace is ignored, including course keys. Your keys stay saved: they are used again if you switch back to Your own API keys.
Follow costs and key health
Section titled “Follow costs and key health”- Costs: Your provider bills you directly. SlideMind shows estimated costs in USD, based on provider prices: on the Overview dashboard (Estimated AI cost) and in Activity (Estimated provider cost · BYOK).
- Warnings: The Needs your attention card of the dashboard warns you when a key failed its last test, when the default provider has no valid key, or when the workspace has slides but no key at all.
- Audit: Saving, testing and deleting a key, and changing the default provider, are recorded in the Security tab of Activity, which only owners can open.
Next steps
Section titled “Next steps”- Models and response settings: choose the model each slide uses.
- Choosing how AI is funded: compare your own keys with SlideMind Credits.
- Data, AI providers and your responsibilities: what reaches your provider.
- Troubleshooting: fix a slide that stopped answering.