Skip to main content

Bring your own keys

Status: planned. BYOK is on the roadmap but not yet available. Nothing on this page works today; it describes what's coming so you can plan for it. Details may change before release.

Today, every request runs on MindsHub's provider accounts and bills as described in Billing. BYOK will let you attach your own provider API keys (OpenAI, Anthropic, Gemini, and others) so that requests to those providers run on your account and contracts instead.

What it will look like​

  • Add keys in settings. One key per provider, validated with a live call when you save it. Keys are write-only: stored encrypted, never displayed again. You'll see the provider, a masked hint, and a validation status.
  • Your key wins. Once you've added, say, an Anthropic key, every request you make that resolves to an Anthropic-backed model runs on your key. Same aliases, same routing; only the account behind them changes.
  • Billing follows the key. Requests served on your key don't consume your MindsHub included tokens and don't draw your wallet. They're still metered for visibility and still subject to rate limits.
  • You choose what happens on providers you haven't keyed. The default is "fill the gaps": those models keep working on MindsHub's keys, billed normally. The alternative is "my keys only": models on un-keyed providers show as unavailable. Use that mode if inference must never run on an account you don't control.
  • Provider errors surface directly. If your key is rejected or out of credit upstream, the error says so with a distinct code rather than presenting as a MindsHub failure.

Provider keys only, not subscriptions​

BYOK is for provider API keys: the kind you get from an OpenAI or Anthropic developer console, with per-token billing attached.

Consumer subscriptions can't be attached. A Claude Pro/Max or ChatGPT Plus subscription authenticates through OAuth tokens scoped to the vendor's own applications, not through developer API keys.

In the meantime​

If your requirement is contractual, meaning inference must run through your own provider account, contact support@mindsdb.com; it helps us prioritize. If your need is capacity, wallet billing has no usage ceiling beyond the rate limits.