Bring your own key (BYOK), explained

  • AI and data
  • Pricing
  • BYOK
Try wuup free

7 min readBy

Bring your own key (BYOK) means you paste an API key from an AI provider, such as OpenAI, Anthropic, OpenRouter, Google Gemini or Groq, into a tool, and the tool sends its model calls on your account. You pay the provider directly at their per-token prices, and the tool does not resell model usage to you. In wuup, BYOK works with all four of those providers and wuup charges nothing for it; without a key, you get 50 free questions on Gemini. This guide covers how BYOK works, what it really costs, and what to check before you paste a key anywhere.

How BYOK works

Every AI answer is one or more calls to a model API. Someone pays for those tokens. There are two ways a tool can arrange that:

  • Bundled. The tool holds its own provider account, pays for tokens and charges you a subscription or credits that include a margin. Simple, but you pay the markup, and the tool chooses the model.
  • BYOK. You create an API key in your own provider account and give it to the tool. The tool calls the provider with your key. The provider bills you for exactly the tokens used, and the tool charges for its software, or in wuup's case, nothing.

The tool still does all the work around the model: connecting to your data, writing and checking queries, building charts, and keeping chat history. Only the model calls move to your account.

Bundled pricingBring your own key
Who pays the providerThe toolYou, directly
Markup on tokensUsually, inside the plan priceNone from the tool
Model choiceThe tool'sAny model your key can access
Spend controlsThe tool's plan limitsYour provider's budgets and limits
Data terms for promptsTool's agreement with the providerYour own agreement with the provider

Why people choose BYOK

Cost transparency. You see every request on your provider's usage dashboard. Heavy months cost more, light months cost less, and there is no seat fee for capacity you do not use.

Model choice. You can pick a fast cheap model for routine counts and a stronger model for harder analysis. With OpenRouter, one key reaches models from many providers, and Groq serves open models very fast.

Your provider terms. Prompts and responses are governed by your own agreement with the provider. If your company already has an enterprise agreement with OpenAI, Anthropic or Google, BYOK keeps model traffic under that agreement.

No lock-in. Delete the key and the tool stops making calls on your account immediately.

When bundled pricing is the better deal. BYOK is not always cheaper. If a tool includes a generous model allowance in a flat plan and you are a heavy user, the vendor's volume pricing can beat your own pay-as-you-go rate. Bundled plans also suit teams where nobody is allowed to create provider accounts or hold API keys. And if you only ask a handful of questions a month, the difference is a few cents either way, so pick whichever is simpler to approve.

The trade-off is a little setup, and you manage spend limits yourself. The setup guide takes about two minutes.

How BYOK works in wuup

  1. Create a key in your provider's console: OpenAI, Anthropic, OpenRouter, Google AI Studio for Gemini, or the GroqCloud console for Groq.
  2. Paste it into wuup under Settings and choose the provider.
  3. wuup validates it by listing the models your key can access, which costs no tokens. For Gemini, it also sends one tiny test request to confirm your key works from wuup's server region. Invalid keys are rejected with the provider's reason.
  4. Pick a model from the list your key returned, or leave it on automatic.
  5. Ask questions. Calls now go to your provider on your key. wuup adds no charge.

After saving, the key is shown masked (only the first four and last four characters), and you can delete it at any time from the same screen. Deleting removes the key and the cached model list from your account, and wuup goes back to any free questions you have left.

All of wuup's features work with your own key: the read-only MongoDB connector, Google Sheets, document Q&A with citations, charts built from real rows, and the queries shown under each answer. Tool calling (the way the model asks wuup to run a query) is supported on all four providers.

What a month of data questions costs

A data question is usually several model calls: the model reads the schema digest, calls a tool to query, reads the result and writes the answer, sometimes with a second query. So the cost depends on the model, how many tool calls a question needs, and how large the results are.

Here is a worked example with clearly assumed numbers. Assume one typical question uses 12,000 input tokens and 1,500 output tokens across all its calls, and you ask 500 questions a month. Prices are standard per-million-token rates from each provider's pricing page, checked October 2026.

ModelInput price per 1MOutput price per 1MCost per question500 questions
OpenAI gpt-4o-mini0.15 dollars0.60 dollarsabout 0.003 dollarsabout 1.35 dollars
Gemini 2.5 Flash0.30 dollars2.50 dollarsabout 0.007 dollarsabout 3.68 dollars
Claude Sonnet 5.52 dollars10 dollarsabout 0.039 dollarsabout 19.50 dollars

The arithmetic for Gemini 2.5 Flash: 12,000 input tokens at 0.30 dollars per million is 0.0036 dollars, and 1,500 output tokens at 2.50 dollars per million is 0.00375 dollars, so about 0.0074 dollars per question.

Your real numbers will differ. Questions over wide documents or large result sets use more input tokens, and reasoning models bill thinking tokens as output. Check a week of usage on your provider dashboard and multiply out. wuup keeps result sizes bounded (MongoDB queries return at most 100 rows and 50 KB), which also keeps input tokens predictable.

OpenRouter passes through the underlying providers' prices with no markup on inference, and charges a 5.5% fee (0.80 dollar minimum) when you buy credits, per its FAQ. It is a convenient way to try several models with one key.

Groq runs open models, such as Llama and GPT-OSS, on its own inference hardware, so answers come back very fast. It bills per token at the rates on its pricing page, and its free plan has rate limits. See Groq in wuup.

The free tier, and when to switch

Without a key, every account gets 50 free questions on Gemini. That is enough to connect a source, try real questions and see whether wuup fits. When the free questions run out, wuup tells you, and adding a key unlocks unlimited questions billed by your provider. See pricing and the BYOK overview.

Switch earlier if you want a specific model, if your company requires model traffic under its own provider agreement, or if you plan to ask more than a few questions a day.

Try it in wuupSet up your own key in two minutesStep-by-step instructions for OpenAI, Anthropic, OpenRouter, Gemini and Groq keys, including how to set a spending limit.Learn more

What to check before pasting a key into any tool

BYOK moves trust from the tool's bill to the tool's handling of your key. Before pasting a key anywhere, ask:

  • Is the key validated without spending tokens? Listing models is a free check; a tool that runs a big test prompt is spending your money.
  • Is it masked after saving and deletable any time? You should never be able to read the full key back from the UI.
  • How is it stored? Ask whether keys are encrypted at rest, and prefer a dedicated key with a spending cap either way.
  • Where do prompts go? Prompts should go to your provider, not to a third party you did not choose.
  • What data is sent in prompts? With databases, sensitive fields should be removed before anything reaches the model. wuup hides fields such as passwords, tokens and card numbers from the model by default; our database safety checklist covers this in detail.

FAQ

Does wuup charge anything when I use my own key?

No. With your own key, wuup charges nothing; you pay your provider directly for the tokens your questions use.

Which providers does wuup support for BYOK?

OpenAI, Anthropic, OpenRouter, Google Gemini and Groq. Through OpenRouter you can reach many more models with one key, and Groq is the fast option for open models.

Can I switch providers later?

Yes. Delete the current key and add one from another provider. Your chats and connected sources stay as they are.

Will my provider train on my prompts?

That depends on your provider's API terms, not on wuup. Major providers publish API data-usage policies; check the one that applies to your account.

What happens if my key runs out of credit?

The provider rejects the request and wuup shows the provider's error. Top up or raise your limit in the provider's console, or delete the key to return to any remaining free questions.

Ask your data a question.
See the query behind the answer.