Workspaces on Pro and up can bring their own AI provider keys to Taskade. AI agents, Taskade EVE, and automation steps then run on your own provider account, and your provider bills you directly.
TL;DR: On Pro and up, add an OpenAI, Anthropic, or Google key under Connections → AI Model Keys. Business and up also takes keys from more AI hosts, such as xAI and Groq. Agents, Taskade EVE, and AI steps on a model from that provider run on your account. A failed key can fall back to credits. See the Plan Matrix.
In this guide, you will:
- Decide whether your own keys fit your team
- Add a provider key to a space
- See which AI requests run on your key
- Run Taskade EVE on your key
- Choose what happens when a key fails
- Rotate, rename, or delete a key
Inside the video: New: Bring Your Own AI Keys (BYOK) in Taskade Genesis AI Agents
Bring your own AI keys so that Taskade AI agents call the provider on your own account, with your billing and your rate limits. The video plugs in OpenAI and Anthropic keys and calls the result "compliance friendly, billing visible." Among the plans on sale, your own keys are available on Pro and up.
Video: New: Bring Your Own AI Keys (BYOK) in Taskade Genesis AI Agents · 0:20 · published 2026-06-01 · Watch on YouTube
Key steps
- Get an API key from your AI provider.
- Add the key to the agent, as the video shows, or add it for a whole space under Connections → AI Model Keys.
- Pin a model from that provider on the agent. Requests from that agent then go to your provider account.
A key for a whole space is the default for every agent in that space that has no key of its own. An agent on Auto can use that key too, when Taskade picks a model from the same provider.
Timestamps
- 0:02 Bring your own API keys
- 0:06 Your AI teammates call providers directly
- 0:08 Your account, your billing, your rate limits
- 0:11 Set keys in agent settings
- 0:13 Compliance friendly, billing visible
Try it: Plan Matrix · Create an agent · Create an AI Agent walkthrough
Before You Start
Your own keys need a paid plan and a key from your AI provider.
| Requirement | Details |
|---|---|
| Plan | OpenAI, Anthropic, Google Vertex AI, and Google Gemini API keys: Pro and up. Every other provider: Business and up. The AppSumo and PitchGround lifetime tiers also include the Pro providers. |
| Who can do this | Workspace owners and members whose role lets them manage the workspace. Other members do not see the Add an AI key button. |
| What you need | An API key from your AI provider. Google Vertex AI takes a service account key (JSON). Azure OpenAI also needs its resource name, and Cloudflare Workers AI its account ID |
| Time | About 5 minutes for each provider |
Know When Your Own Keys Fit
Your own keys fit when your company must own the AI bill or the data path.
| Situation | Why your own key helps |
|---|---|
| Procurement approved your provider account | The AI bill lands on the provider invoice that finance already approves. |
| Compliance owns the data path | Traffic flows through the provider account where your audit log lives. |
| Your volume is high | You can negotiate better provider pricing than the bundled credits give you. |
For everything else, Taskade credits are simpler and need no key rotation.
Step 1: Add Your Keys
Keys live on the Connections page of a space, under AI Model Keys.
- Open the space that you want the keys to cover.
- Go to Connections and find AI Model Keys.
- Click Add an AI key. The Add an AI key dialog opens.
- Under Provider, pick your AI provider. If a provider row shows an upgrade badge, your plan does not include that provider yet. Click the row to see the plan that unlocks it.
- Type a Key name, for example "Engineering key".
- Paste your API key. For Google Vertex AI, paste the Service account key (JSON) instead. For Azure OpenAI, also type the Resource name. For Cloudflare Workers AI, also type the Account ID. If you do not have a key yet, click Get a key to open the key page of the provider.
- Click Save key. Taskade checks the key with the provider before it saves it.
┌──────────────────────────────────────────────────────────────┐
│ AI Model Keys [ Add an AI key ] │
│ Use your own OpenAI, Anthropic or other AI key. Agents use │
│ it instead of Taskade credits, and each automation AI step │
│ on it uses 10 credits. │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Engineering key ••••a1b2 Active │ │
│ │ OpenAI key added on [date] │ │
│ └────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
The 10-credit step fee applies on subscription plans. AppSumo and PitchGround lifetime tiers pay no step fee, so their box does not mention one.
The list shows each key by name, with only its last four characters or, for Google, the service account email. Repeat the steps for each provider that you want to use.
On Free and Starter, the Add an AI key button carries a Pro badge and opens the upgrade page. A key saved on a paid plan stays in the list after a downgrade, with an upgrade note on the row. Taskade credits serve its work until you upgrade again.
Where a Key Applies
A key belongs to the space where you added it, and it serves that space by default.
- Root keys reach subspaces. A key in the root workspace also serves the agents in its subspaces. A subspace key of the same provider takes over from the root key. Automation steps use the keys of their own space only.
- No setup for each agent. Inside the space, the key is the default for AI agents and for the built-in Taskade AI automation steps.
- The model decides the key. Your key serves an agent or step whose model comes from that provider. When you add an OpenAI key, the dialog says: "Agents in this space with no key of their own, TSK-Auto included, will use this key."
- Automation steps on TSK-Auto use credits. An AI step uses your key only when you pick a specific model for the step.
- Google keys serve Google models only. Gemini does not run on Taskade credits. With a Google Vertex AI or Google Gemini API key saved, the agent model menu lists Gemini rows under Your keys.
- Some keys need a pick on each agent. Groq, Mistral, Together AI, OpenRouter, Fireworks, Moonshot AI, Cerebras, Google Gemini API, Azure OpenAI, and Cloudflare Workers AI keys are not a default for the space. Pick a row under Your keys in the agent model menu. The row saves the model and the key together. If the agent has no such key, it runs on Auto.
See What Runs on Your Keys
After you add a key, AI requests from these places go through your provider account.
| Surface | Runs on your key |
|---|---|
| Custom AI agents in agent chat, for a signed-in teammate | Yes, when the agent's model, or the model that Auto picks, comes from a provider that you added. Your plan includes agent steps on your key each month. Each step after that uses a fixed step fee in credits, and a daily cap applies |
| Built-in Taskade AI steps, such as Ask AI and Categorize with AI | Yes, when the step's model comes from a provider that you added. Each step uses a fixed step fee in credits. A step on TSK-Auto uses Taskade credits at the model price |
| Ask an agent steps and public agent embeds | Only when the key is set on that agent directly |
| Taskade Genesis app building and Taskade EVE chat | Yes, when you pick a model under Your keys in the Taskade EVE model menu. Each Taskade EVE step on your key uses a fixed step fee in credits. TSK-Auto and the TSK tiers use Taskade credits |
| Models from providers that you did not add | No. They use Taskade credits. |
Built-in Taskade AI steps offer TSK-Auto and the TSK tiers. Each TSK tier runs on a model from one provider. Run one test step on each tier that you use, then look in your provider dashboard to see which tiers your key serves. See Taskade AI for the menu on each step.
A key that you set on one agent yourself keeps working everywhere that agent runs. Tell your team about these rules before you turn on your own keys.
Run Taskade EVE on Your Key
Taskade EVE can build and edit your Taskade Genesis apps on your own key. A key serves Taskade EVE only when you pick it in the chat.
- Open a Taskade EVE chat in the space that has your key.
- Open the model menu under the message box.
- Pick a model under Your keys, at the end of the list. A row that reads Tested for app builds passed a Taskade EVE build test. A row that reads Untested did not have that test yet.
- Send your message. Taskade EVE keeps that pick for the chat.
Each Taskade EVE step on your key uses a fixed step fee in credits, and your provider bills you for the model. If you pick TSK-Auto or a TSK tier, Taskade EVE uses Taskade credits. Taskade EVE on your key needs Pro and up. On AppSumo and PitchGround lifetime tiers, your key serves agents and automation steps, and Taskade EVE stays on credits.
Choose What Happens When a Key Fails
A key can fail when the provider refuses it or its provider account runs out of funds. The AI Model Keys panel has a switch for this case: Use Taskade credits when a key fails. The switch is on by default, and it applies to the whole workspace.
| Switch | What happens when a key fails before a reply starts |
|---|---|
| On (default) | The reply runs on Taskade credits, and the chat shows a short notice. |
| Off | The reply stops, and the chat shows Your AI key needs attention with a pointer to the key. |
Public agents never fall back to credits. An automation AI step falls back only when its key fails before the provider call. Only a workspace owner, or a member whose role lets them manage the workspace, can change the switch.
Each key in the list also shows a status:
| Status | Meaning | What to do |
|---|---|---|
| Active | The key works. | Nothing. |
| Rejected | The provider refused this key. | Replace it or delete it. |
| Key out of funds | The provider account of this key has no funds left. | Add funds at the provider. |
| Unreachable | Taskade cannot reach the provider with this key. | Wait, then test again. |
| Unreadable | Taskade cannot read this saved key. | Add it again or delete it. |
Step 2: Test Before You Cut Over
A test call in your provider dashboard proves that the key works.
- Pin a model from your provider on one agent, and send the agent a chat message.
- Set one Ask AI automation step to a TSK tier, and run it.
- Make sure that each call shows in your provider dashboard.
Test with a pinned model. An agent on Auto can land on a model from another provider, so a test on Auto does not prove that your key works.
You Are Done When
Your key shows as Active under AI Model Keys, and your test calls show in your provider dashboard.
Rotate, Rename, or Delete a Key
Taskade uses the newest active key for each provider, so a new key takes over from the old one.
- Make a new key in your provider dashboard.
- In the space, open Connections → AI Model Keys.
- Click Add an AI key, pick the same provider, and paste the new key.
- Click Save key.
If no other tool uses the old key, revoke it at the provider.
To rename or delete a key, open the options menu on the key row and pick Rename or Delete key. Before a delete, the dialog tells you where the work moves:
- If another active key of the same provider exists, agents and AI steps move to the newest one.
- If no other key exists and the credit fallback is on, they use Taskade credits.
- If no other key exists and the credit fallback is off, agents on the deleted key stop until you pick another key.
Tips
- Limit who can rotate keys. Only workspace owners, and members whose role lets them manage the workspace, can add or replace a key. Keep those roles tight and audited.
- Combine with SSO. Most teams that need their own keys also need single sign-on for governance.
- Keep automations on your key. Give each automation AI step a TSK tier that your key serves, not TSK-Auto.
Frequently Asked Questions
Which plans can bring their own AI keys?
OpenAI, Anthropic, Google Vertex AI, and Google Gemini API keys work on Pro and up. Keys from every other provider need Business and up. The AppSumo and PitchGround lifetime tiers also include the Pro providers. On Free and Starter, the Add an AI key button opens the upgrade page.
Which AI providers can I connect?
On Pro and up: OpenAI, Anthropic, Google Vertex AI, and Google Gemini API. On Business and up: xAI, OpenRouter, Fireworks, Groq, Mistral, Together AI, DeepSeek, Z.ai, Moonshot AI, Alibaba Qwen, Cerebras, Azure OpenAI, and Cloudflare Workers AI. Google Vertex AI takes a Google Cloud service account key in JSON. The others take an API key.
A built-in AI step can run on a key from OpenAI, Anthropic, Google Vertex AI, xAI, DeepSeek, Z.ai, or Alibaba Qwen. The saved model of the step must come from that provider. A new step offers TSK-Auto and the TSK tiers, and only some tiers run on your key. The other keys serve agents and Taskade EVE only. See AI model key providers for the models that each key serves.
Does my key cover Taskade Genesis app building?
Yes, when you pick a model under Your keys in the Taskade EVE model menu. Each Taskade EVE step on your key uses a fixed step fee in credits. A chat on TSK-Auto or a TSK tier uses Taskade credits.
Why does a request still use Taskade credits?
The model comes from a provider that you did not add, or an automation step is on TSK-Auto. A failed key with the credit fallback on also uses credits. A built-in AI step or a Taskade EVE step on your key uses a fixed step fee in credits, the same for every model. An agent step on your key uses that fee only after the steps that your plan includes each month. Settings → Credits shows how many of them you used. Pick a model from your provider, and make sure that the key shows Active.
Can someone read my key after I save it?
No. Taskade stores keys encrypted and never shows them again. The list shows only the last four characters, or the service account email for Google.
Next Steps
Pair your keys with the rest of your admin controls.
- Compare plans: See which plans include BYOK in the Plan Matrix.
- Set up single sign-on: Follow SAML SSO with Google.
- Control who edits agents: See Roles and Permissions.
- Add per-step connectors: See Bring Your Own AI Key. Compare costs in AI Models & Credit Costs.
- Talk to sales: See Enterprise plan details on the Pricing page.