Skip to main content
ToeBox supports Bring Your Own Key (BYOK), letting you use your own API keys from AI providers instead of ToeBox’s built-in credits.

​
Why use your own keys?

  • Cost control — Pay your AI provider directly and avoid per-credit pricing
  • Higher rate limits — Use your own account’s rate limits instead of shared platform limits
  • Model access — Access models that may not be available on ToeBox’s default tier
  • Enterprise compliance — Route API calls through your own provider agreements and data processing terms

​
Supported providers

​
Setting up BYOK

1

Navigate to Settings

Go to Settings in the ToeBox sidebar. Scroll down to the AI Model Keys section.
2

Enter your API key

Click the provider you want to configure and paste your API key. Supported providers:
3

Test the key

Click Test to verify that the key is valid and has the necessary permissions. ToeBox will make a small test request to confirm connectivity.
4

Save

Click Save. Your key is now active and will be used for all agent and assistant requests that use models from that provider.

​
How keys are stored

Your API keys are stored locally in your browser only. They are never sent to or stored on ToeBox servers. Keys are included in API requests directly from your browser to the AI provider.
This means:
  • Keys do not persist across browsers or devices
  • Clearing your browser data will remove stored keys
  • Other team members must enter their own keys

​
Fallback behavior

ToeBox uses a priority chain when making AI requests:
  1. Your BYOK key — If you have entered a key for the model’s provider, it is used first
  2. Platform key — If no BYOK key is configured, ToeBox uses its built-in platform credits (subject to your plan’s credit limits)
This fallback is automatic. If your BYOK key is invalid or expired, ToeBox will fall back to platform credits and display a warning.

​
Managing keys

  • Update — Paste a new key to replace the existing one
  • Remove — Clear the key field and save to remove a BYOK key
  • Test — Re-test a key at any time to verify it is still valid
If you use ToeBox heavily, BYOK with an Anthropic key is often more cost-effective than relying on platform credits, especially on the Free or Starter plans.