In this section · 6 articles

An AI provider can't be connected or switched on

The AI Providers list is empty, a provider stays Inactive, Test Connection fails or answers This action is unauthorized., or saving refuses to activate it. Find the cause and fix it.

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

Symptom

One of these, on AI Manager › AI Providers:

What you seeGo to
No records found: no providers at all1
You chose Active for a new provider, and it shows Inactive2
This provider cannot be activated until these credentials are set: and a field name3
This provider cannot be activated because the module that supplies its driver is not installed or is disabled., or Availability shows Driver missing4
Test Connection shows an error5
Test Connection answers This action is unauthorized.6
Test Connection seems to do nothing7
New provider says Every installed driver already has a provider here, so there is nothing left to add.8

Once a provider shows Ready under Availability and requests still fail, see AI requests fail or are skipped.

Check these, in order

1. The list is empty after an install from Addons

When AI Manager is installed from Addons, its list of providers isn't filled in, so AI Providers starts empty.

Fix: Select New provider, choose the provider, and save. Repeat for each provider you want. Then add your key as described in Connect an AI provider, and set up the provider's models in Set up models and rates.

2. A new provider was saved as Inactive

A provider you add is always saved as Inactive, whatever you choose on the form. That's on purpose, so a provider isn't used before its key is tested.

Fix: Add the key, run Test Connection, then open the provider's actions menu, select Edit, set Status to Active and select Save.

3. The key isn't saved

Saving with Status set to Active is refused while a required field, usually API key, is empty. The message names the field.

Fix: Paste the key into API key and save again. You can paste the key and switch the provider on in the same save. After saving, the field shows Stored - leave blank to keep it. That's expected: the key is never shown again.

4. The add-on that brings the provider is off

Some providers come from another add-on. While that add-on is turned off or not installed, the provider shows Driver missing and can't be switched on.

Fix: Turn the add-on back on in Addons › Addon Management, then activate the provider.

5. The test fails

Test Connection asks the provider for its list of models. It costs nothing and sends none of your content.

MessageWhat to do
Required credentials are blank, so nothing was sent.Paste the key into API key and select Save first. The test only uses saved details.
The provider rejected these credentials.The key is wrong, revoked, or has no access to the API. Create a new key in the provider's console and paste it again.
The provider could not be reached. This says nothing about the credentials.Check Base URL: leave it empty unless you use a different service, and if you set it, it must start with https://. Ask whoever runs your server to check that it can make outgoing secure web connections to the provider. Then try again.
No endpoint is configured for this provider.Enter the service's address in Base URL and save.
This provider's driver cannot verify credentials.The provider can't be tested. Switch it on, then check that requests work in AI Manager › Usage & Cost.

On the edit form, Base URL looks empty and shows the public address in gray, even when you saved your own address. The saved value is kept unless you type a new one.

6. Test Connection is refused

This action is unauthorized. means you can't run the test. Test Connection needs two permissions: Run an AI provider connection test (feature.ai.provider.test) and Edit an AI provider and its credentials (feature.ai.provider.edit). With only the first, the button shows but is refused.

Fix: Give the person's role Edit an AI provider and its credentials too, or ask someone who has it to run the test. See AI Manager settings and permissions.

7. The test passed, but nothing seems to change

A successful test shows no message of its own. It updates the provider's Last verified time, which is hidden in the list until you add it from the columns menu.

Fix: Add the Last verified column, and check that its time is now.

8. New provider has nothing left to add

Every provider AI Manager supports already has a row in the list.

Fix: Look for the provider in the list and edit it there. If you deleted it, restore it from the trash to get its key and settings back. A new kind of provider only appears when you install an add-on that brings one.

Other features stopped after you turned on AI Manager

If scheduled jobs, emails or other background work stopped when AI Manager was turned on, update AI Manager to 2.3.1 or later. See Scheduled jobs don't run.

Still not working?

Raise a ticket from Support Center in your Laramin app. Include this page's link, the provider, and the exact message you see. Never include your API key.