AI providers: your own keys (optional)

Settings, section AI providers (/app/settings#ai). Keys belong to the whole account: a key saved here is used in every workspace, so only the account owner (the owner of the organisation's first workspace, see Your data) adds, changes or removes them and chooses which key runs first. An Admin, or the Owner of a workspace created later, sees "Only the account owner can change this. It applies to every workspace in the account, so ask the account owner."; other roles see "You do not have access to this". Developer API keys can never change AI keys.

Before you start

You need an API key from the provider's own website and credit or billing on that account. Each row has a Get a key link and a note on what the provider needs:

• Anthropic (Claude): needs credit on the Anthropic account to generate.
• OpenAI (GPT): needs an active billing balance/quota at OpenAI.
• Google Gemini: enable the Generative Language API for the key's Google Cloud project.
• xAI Grok: your xAI team needs credits (console.x.ai billing).
• Runway: for AI video only; your Runway developer account needs credits (dev.runwayml.com).

Step by step

1. In the form under the list, choose the provider in the first box.
2. Paste the key into API key.
3. Optionally type a model name into Model (optional); leave it empty to use the provider's default.
4. Click Save key. The button shows "Validating…" while OmniBrand asks the provider whether the key works.
5. On success the row shows ••••and the last four characters (and the model, if you gave one).
6. If the provider refuses, a red box right under the Save key button explains why (for example "Invalid key - copy a fresh key from console.anthropic.com/settings/keys." or "Key valid but out of quota/credits"), and the API key box is outlined in red. Fix it and save again, or click Save anyway (skip validation) in that red box: the key is stored with an unverified badge and a Verify now button you can press later.

Which key runs first

The Which key runs first card says whether your package includes credits on OmniBrand's own keys. When it does, it reads "Your package includes credits on OmniBrand's keys. Choose whether they are used before your own keys." and offers the choice below. When it does not, it says only "This package includes no credits on OmniBrand's keys; your own keys are used for everything." and offers no choice. During an AI trial it says instead "Your Pro trial includes 20 AI texts and 5 AI images on OmniBrand's keys until [date]. They are used while you have no AI key of your own; once you add one, your own key runs first and nothing is counted." (on a new account's 3-day AI trial: "Your free AI trial includes ..."), with "Left: [texts] AI texts and [images] AI images · [days] days left" under it, and "Until you confirm your email address, the trial is limited to 5 AI texts and 1 AI image." while the address is unconfirmed.

• Use the included credits first, then my own keys: the package's credits are spent first.
• Use the included credits, then purchased ones, then my own keys: appears while you hold purchased credits and have a key of your own. Purchased credits are spent before your key. Without this choice your key answers once the included credits run out, and the page says how many purchased credits are waiting.
• Always use my own keys (never counted): your keys are used for everything and nothing is counted against the package. It can be chosen only once you have saved a key of your own; until then it is greyed out with "Save a key of your own in the AI providers card first." If it is chosen and you have no key (for example after removing it), the card says "You have no key of your own yet, so included credits are still used."

The line above the choice says how many included credits are used this month and when they reset.

Fields and options

• Provider: Anthropic (Claude), OpenAI (GPT), Google Gemini, xAI Grok, Runway (video). One key per provider; saving a new key for the same provider replaces the old one.
• API key: required. Stored encrypted and never shown again.
• Model (optional): the provider's model name.
• Remove: asks "Remove the (provider) key? AI features stop using it at once. To use it again you will have to paste the key in again." The window is titled Remove AI key?; click Remove to delete the stored key for that provider, or Cancel to keep it.
• "no key" next to a provider means you have not stored a key for that provider.

Good to know

• Your oldest key becomes the default provider.
• The provider bills you directly for what your own keys use; OmniBrand adds nothing on top. If your package does not include AI on your own key, this section names the package that starts it and does not offer the form; keys you already saved stay stored and work again after you subscribe.
• If AI features say you are out of credits, see Plans and Top-ups.

Related

• AI Studio
• The Settings page