How to use your own API key with camelAI, and what each provider unlocks.
camelAI is model-agnostic. By default, paid plans use camelAI’s hosted credits to call whichever model you’ve picked for the thread. If you’d rather use your own API key, you can bring one from any of four providers. This page explains what each option gives you and how to set it up.The agent can run on the major model families camelAI supports: GPT, Gemini, Grok, Kimi, DeepSeek, and Claude. You can switch models any time from the model picker in the chat. Whichever provider you’ve connected determines which models are available to you.
Bringing your own key replaces camelAI’s hosted credits entirely. You can’t mix and match your own key for one model family with camelAI credits for another. All requests go through your one chosen provider. If you need access to multiple model families on a single key, use OpenRouter.
camelAI supports four providers for BYOK. Each unlocks a specific set of models.
Anthropic — Claude models
Unlocks: Claude models, including Opus, Sonnet, and Haiku.Get a key:console.anthropic.com/settings/keysYou’ll need to add a payment method and prepay for credits in the Anthropic console before your key will run requests. A new key with no credits behind it returns a billing error.
OpenAI — GPT models
Unlocks: GPT-5.5, GPT-5.4, and GPT-5.4 Mini.Get a key:platform.openai.com/api-keysLike Anthropic, OpenAI requires you to prepay credits in your OpenAI account before the key will run requests.
OpenRouter — every model camelAI supports, on one key
Unlocks: GPT, Gemini, Grok, Kimi, DeepSeek, and Claude models, all on a single key.Get a key:openrouter.ai/settings/keysOpenRouter is the most flexible BYOK option. Two reasons to pick it:
You want every model camelAI supports on one key. Anthropic, OpenAI, and Bedrock keys lock you into a subset of our models. OpenRouter gives you all of them.
You already have an account with a provider we don’t connect to natively. OpenRouter supports plugging in your own keys for Microsoft Azure, AWS Bedrock, Google Vertex, and others, then routing requests through your account. So if your company runs AI on Azure OpenAI, you can connect your Azure key to OpenRouter, and then connect OpenRouter to camelAI. Usage runs against your Azure bill.
OpenRouter charges a 5% fee on requests routed through your own provider keys, but the first 1 million BYOK requests per month are free. See OpenRouter’s BYOK guide for details.
camelAI doesn’t connect natively to Microsoft Azure OpenAI or Google Vertex AI. Each cloud provider has its own auth model, billing structure, and quirks, and supporting them all directly would slow down our work on the rest of the platform. The good news: if your company is on one of those providers, you can still run camelAI through your existing account by routing through OpenRouter.
When you connect those keys to OpenRouter, OpenRouter forwards your requests to that provider. Usage runs against your Azure (or Vertex, or Bedrock) bill, and OpenRouter charges a 5% fee on top — waived for the first 1 million BYOK requests per month.
Add the key under Settings → AI Provider → OpenRouter.
The same flow works for Google Vertex (Google Cloud service account JSON) or AWS Bedrock through OpenRouter (AWS access key + region).
Native Azure or Vertex support in camelAI isn’t on the near-term roadmap. The OpenRouter pass-through is the recommended path for the foreseeable future, and it’s how most of our customers in this situation are running today.
Choose Anthropic, OpenAI, OpenRouter, or AWS Bedrock.
3
Paste your API key
Paste your API key (and select a region, if you’re using Bedrock).
4
Save
Save the form.
The form has a “Get a key” link next to each provider that takes you to the right page on the provider’s site.You can switch providers any time from the same screen, or remove your key and switch to camelAI hosted credits (paid plans only).
Model costs vary widely. The cheapest models on camelAI are 10–50× less expensive per request than the flagship models, and they handle most everyday work just as well. Pairing a cheaper model with a small OpenRouter top-up is the lowest-cost way to use the platform.
The playbook:
1
Sign up for OpenRouter
Sign up and add the minimum in credits at openrouter.ai/credits. A small top-up goes a long way with cheap models.
Add the key under Settings → AI Provider → OpenRouter.
4
Pick a cheap model in the chat
The most cost-efficient options are:
GPT-5.4 Mini: fast and cost-effective for everyday code and copy work.
Kimi: competitive on price, particularly strong on long-context tasks.
Gemini Flash: fast, low-cost, and useful for general iteration.
DeepSeek Flash: a low-cost option for straightforward coding tasks.
Grok: flexible across general work, often cheaper than flagship models.
5
Reserve flagship models for hard problems
Switch to a flagship model only when a task is genuinely hard (complex reasoning, multi-step debugging, careful design work). Most chat turns don’t need one.
OpenRouter shows the live per-token cost for every model on its models page. Sort by price to compare.
Can I use my own API key for one model and camelAI credits for another?
No. When a BYOK key is set, all of your model usage runs through that one provider. If you want broad model coverage on a single key, use OpenRouter.
Does my API key work across multiple orgs?
No. LLM provider keys are scoped to one org. If you have more than one org, set up a key for each. See Organizations and workspaces for the full breakdown.
Do my plan credits roll over month to month?
No. Monthly plan credits reset each billing cycle. Credits you’ve topped up on top of your plan credits do roll over and don’t expire.
Why does my new API key say "billing error" or "insufficient credits"?
Anthropic, OpenAI, and OpenRouter all let you create an API key without adding any credits. The key won’t work until you prepay credits in their billing settings. This is on the provider’s side, not ours.
Does camelAI charge a markup on hosted credits?
No. We pass through the provider rates at cost. The monthly subscription covers the platform; credits cover model usage at the provider’s rate.
Can I see how much I've spent?
Yes. Settings → Billing shows your current plan, credit balance, and usage history.
Do you support Microsoft Azure OpenAI or Google Vertex AI?