Connect an AI provider
Give a provider such as OpenAI or Gemini your API key, check the connection, and switch it on. Also: choose the order providers are tried in, change a key, and add or remove a provider.
- Applies to
- AI Manager 2.2 and later
- Who can do this
- Platform owner, Administrator
- Permission
feature.ai. provider.edit - Where
- AI Manager › AI Providers
On this page
AI Manager normally lists every provider it can talk to, each switched off and with no key. Connecting one means giving it your key, checking that the key works, and setting it to Active. If AI Manager was installed from Addons, the AI Providers list can start empty: add each provider you want with New provider first.
Before you start
- You need Edit an AI provider and its credentials (
feature.) and, for the connection test, Run an AI provider connection test (ai. provider.edit feature.). Both are in the AI Providers & Models group.ai. provider.test - Create an API key in the provider's own console, for example Google AI Studio for Gemini, or the API keys page of your OpenAI, Anthropic, xAI, DeepSeek, Alibaba Cloud or Moonshot account. Copy it somewhere safe for a moment.
- Read What AI Manager sends to providers, and where it keeps your keys, and check that the provider's terms suit the content your add-ons send.
Add your key
-
In the sidebar, open AI Manager › AI Providers. Each provider shows Inactive, and Availability shows No credentials.
-
Open the provider's actions menu and select Edit.
-
Under Credentials, paste the key into API key.
-
Fill in the other fields only if you need them:
- Base URL: leave it blank to use the provider's public address. For OpenAI, set it to use Azure OpenAI or another service that works the same way. For Qwen and Kimi, set the mainland China address if your key was issued there. It must start with
https://. - Organization ID (OpenAI): your OpenAI organization, if your key belongs to more than one.
- Maximum response tokens (Anthropic): the longest answer Anthropic may give when the model sets no limit. It's 8192 unless you change it.
- Request timeout (seconds): how long to wait for an answer. It's 120 unless you change it, and AI Manager keeps it between 5 and 300.
- Base URL: leave it blank to use the provider's public address. For OpenAI, set it to use Azure OpenAI or another service that works the same way. For Qwen and Kimi, set the mainland China address if your key was issued there. It must start with
-
Leave Status on Inactive for now, and select Save.
You see Provider name updated. The API key field now shows Stored - leave blank to keep it.
Check the connection
-
In the provider's row, select Test Connection. It asks the provider for its list of models, which costs nothing and sends none of your content.
-
If nothing goes wrong, the key works, and the provider's Last verified time is updated. Last verified is hidden until you add it from the columns menu.
If the test fails, you see why:
| Message | What to do |
|---|---|
| The provider rejected these credentials. | The key is wrong, revoked, or has no access to the API. Create a new key and paste it again. |
| The provider could not be reached. This says nothing about the credentials. | Check the Base URL, and that your server can reach the provider. Try again later. |
| Required credentials are blank, so nothing was sent. | Paste the key and save first. |
Switch it on
-
Open the provider's actions menu and select Edit again.
-
Set Status to Active.
-
Set Priority: 1 is tried first. Providers with a higher number are only used when the ones before them fail or are over a limit.
-
Optional: turn on Default provider to put this provider first, whatever its Priority. Only one provider can be the default, so turning it on here turns it off on the others.

-
Select Save.
Availability now shows Ready. Check the provider's models and prices before your add-ons start using it: see Set up models and rates. To cap what it may spend, see Set spending limits and alerts.

If saving shows This provider cannot be activated until these credentials are set: and a field name, paste that value and save again. You can paste a key and switch the provider on in the same save.
Change a key
- Open the provider's actions menu and select Edit.
- Paste the new key into API key. Leave the field blank to keep the stored key.
- Select Save.
The new key is used from the next call. Then revoke the old key in the provider's console.
The edit form doesn't show the Base URL, Organization ID, Maximum response tokens or Request timeout (seconds) you saved. The fields look empty, and Base URL shows the provider's public address in gray, but the saved values are kept unless you type new ones.
Add or remove a provider
When every provider AI Manager supports already has a row, New provider has nothing to offer, and says so. After an install from Addons the list can start empty; then New provider offers every provider. A new provider appears only when an add-on that brings a new provider is installed, or after you delete one.
A provider you add is always saved as Inactive, even if you choose Active on the form. Edit it afterwards to switch it on.
To stop using a provider, set its Status to Inactive. To remove it, open its actions menu and select Delete. The provider moves to the trash with its key, and you can restore it as it was. Deleting it forever from the trash removes its key, settings and models. Its usage records are kept either way.
Thanks. That helps us decide what to write next.
Thanks for telling us what was missing.
You already answered for this article today. Thanks.
We got a lot of answers from your network just now. Try again in a few minutes.
We couldn't send that. Check your connection and try again.
Links in this article
Printed from help.laramin.in. The online article may have changed since.