Skip to content
Open Bluedeer

Can I use my own AI provider key?

How to connect your own OpenRouter key so a workspace's AI model usage is billed to your account, and what changes when you do.

A workspace normally uses its Bluedeer plan for AI model usage. You can connect your own OpenRouter key instead. Then the AI model usage in that workspace is billed to your OpenRouter account and no longer counts against the plan. The workspace still needs its plan, and a few things are not covered by your key. Your own AI provider key is included on paid plans by default; your plan page shows what your plan includes.

What your key covers and what it doesn't

Your key pays for every AI model call in the workspace: chat replies, scheduled tasks, conversation titles, descriptions of pictures you attach, and pictures the assistant creates. None of these take anything from the plan's usage or from extra usage.

Two things are not covered by your key. Bluedeer pays for them itself, so they count against the workspace's plan usage and then, once that runs out, against its extra usage if extra usage is on:

  • Voice transcription: turning your voice messages into text.
  • Some web searches and page reads: most take nothing from your usage, and only those that need a paid search service count. Read How does web search use my usage?.

The AI provider key section lists both under What your key doesn't cover.

In an Enterprise workspace, the owner and admins also choose what makes images and what transcribes voice messages: a model on your key, or Bluedeer. Read Who makes images and transcribes voice messages on an Enterprise workspace's own key?

Connect a key in your personal workspace

  1. Open the account menu at the bottom of the sidebar, then select Manage workspace.
  2. Select Settings, then AI provider key.
  3. Choose what happens if the key stops working. Stop and show an error fails each message with an explanation until the key works again, and takes nothing from the plan's usage. Use the plan's usage instead keeps messages working, counted against the plan's usage, until the key works again.
  4. Connect the key in one of two ways:
    • Sign in with OpenRouter: approve Bluedeer at OpenRouter, and it creates a key for this workspace. There is nothing to copy.
    • Paste a key: paste an OpenRouter key into the OpenRouter key box, then select Save key. Bluedeer checks the key with OpenRouter before it saves it, and never shows it again.

Connect a key in a shared workspace

Only the workspace's owner and admins can connect or change the key. Open the Workspace page, select Settings, then select AI provider key. Everyone in the workspace uses the key, and it does not apply to anyone's personal workspace. A shared workspace can always use its own key, whatever plan each person has on their own account. Each person who uses the workspace still needs a seat in it.

Replace, check or remove the key

  • Check now checks the key with OpenRouter again and updates the figures shown under From your OpenRouter account. Read What do the spending figures on my AI provider key mean?.
  • Replace key opens a box for a new key. The new key takes over from the next message. The key in use stays until the new one is saved. Select Keep this key to close the box without changing it.
  • Remove key asks you to confirm. From the next message, the workspace uses its Bluedeer plan again. Removing the key here does not revoke it at OpenRouter, so delete it there too if you no longer need it.

Bluedeer emails the person who made any change to the key, the workspace's owner and every admin; the email shows only the last four characters of the key. These emails are essential, so they are always sent and can't be turned off. For all the essential emails Bluedeer sends, see Which emails does Bluedeer send?.

If your plan stops including your own key

Your saved key is kept, but it is not used. The key shows Not in use, and the panel names the plans that include your own key. Select Upgrade to use your own key to use it again, or select Remove key.

For the plans, see What each Bluedeer plan includes.