Bring Your Own Keys (BYOK)

Use your own provider API keys with Anannas for enhanced control over rate limits and billing.

With BYOK, you can route requests through your own provider accounts while still using Anannas as your unified gateway. This gives you direct visibility into provider-level usage and billing while letting Anannas handle the routing complexity.

Your keys are encrypted at rest and only used for requests to their respective providers. Anannas credits remain available as a fallback when your provider keys encounter issues; unless you choose otherwise.

Configure and manage your provider keys in account settings.

You can add multiple provider keys and toggle them on/off anytime. When a key is disabled, it won’t be used for routing.

Getting started

1. Open Integrations (BYOK)

   Navigate to the Integrations (BYOK) section in your dashboard sidebar.

2. Choose a provider

   Select from the available providers.

3. Add your key

   Click “Add key” and fill in the popup with Name and Key.

4. Configure options

   Toggle “Enabled” to activate routing; optionally enable “Always use this key” to disable fallback.

5. Save

   Save your configuration.

Need help getting started with Anannas? Check the QuickStart guide for client setup and examples.

Supported providers

Anthropic

In the Add key popup, provide:

• Name — identifier for your key
• Key — your Anthropic API key
• Enabled — activate routing via your account
• Always use this key — disable fallback to Anannas credits

You can obtain your API key from your Anthropic account. See Anthropic’s docs for more info.

xAI (Grok)

In the Add key popup, provide:

• Name — identifier for your key
• Key — your xAI API key
• Enabled — activate routing via your account
• Always use this key — disable fallback to Anannas credits

You can obtain your API key from your xAI account. Check out xAI’s docs for more info.

Nebius

In the Add key popup, provide:

• Name — identifier for your key
• Key — your Nebius API key
• Enabled — activate routing via your account
• Always use this key — disable fallback to Anannas credits

You can obtain your API key from your Nebius account. See Nebius docs for more info.

We’re actively expanding provider support. Want your provider listed? Reach out — we’re happy to integrate.

Key priority and fallback

Anannas prioritizes your provider key when present and Enabled. If your key hits a rate limit or errors, we fall back to Anannas credits so your calls keep flowing.

Turn on “Always use this key” to disable fallback. With that enabled, we’ll only use your key; you may see rate limit errors if your provider rejects the request.

Pricing

Check BYOK Pricing

For current BYOK pricing and provider/model rates, visit anannas.ai/models.

BYOK usage is billed at 5% of the underlying provider/model price, waived for the first 1M BYOK requests per month.

Your provider still bills usage directly when your key is used; the 5% BYOK fee is separate and applies on the Anannas side.

Using BYOK in clients

No code changes are required in your client — routing uses your configured keys automatically.

python

from openai import OpenAI

client = OpenAI(
  base_url="https://api.anannas.ai/v1",
  api_key="<ANANNAS_API_KEY>",
)

resp = client.chat.completions.create(
  model="anthropic/claude-3.7-sonnet",
  messages=[{"role": "user", "content": "Hello from Anannas!"}],
)
print(resp.choices[0].message.content)

When to enable “Always use this key”

Enable this option if you need strict guarantees that all requests go through your provider account (for auditing, compliance, or budget tracking). If disabled, Anannas falls back to platform credits when your key hits errors or limits; keeping your app running smoothly.

Was this page helpful?

👍 Yes

👎 No