Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.anannas.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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.
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. 
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?