Providers and your own keys
Add provider keys, read provider health, and know what happens when one fails.
If you are running bring-your-own-key, this is where your keys live. If you are on managed AI, this tab still matters — it is where you see provider health.
Adding a key
- Open Settings → Providers.
- Add a key for each provider you want available. More providers means more room for the router to choose well.
- Confirm each shows healthy. A key that saves but fails its first call shows an error here, not at the moment a piece of work dies.
You're done when every key you added reads healthy.
Reading provider health
The Providers tab badges when something is wrong, and the badge distinguishes two states worth telling apart:
- Quota — you have hit a limit at that provider. Work continues on other providers.
- Error — the provider rejected the call. Usually a bad or revoked key.
The badge clears when you open the tab, and reappears only for a genuinely new alert.
Gotchas
- One provider is a single point of failure. With one key and a quota problem, work stops. With three, the router routes around it.
- A key with no spend limit at the provider is your risk, not Foreman's. Set limits on the provider's side if that matters to you.
- Adding a key does not change your plan. See Billing.