BYOK, or bring your own key, means you keep your own accounts with model providers like OpenAI, Anthropic, and AWS Bedrock, and you plug those provider keys into the gateway once. Your applications never touch the raw provider keys again. They talk to one TrueFoundry AI Gateway endpoint using a single gateway key, and the gateway forwards each call to the right provider with your credentials.

This is the opposite of a reseller model where you buy tokens from a middleman. With BYOK you keep your own provider contracts, pricing, and rate limits, and you add centralized governance on top.

Why route provider keys through the gateway

Handing raw provider keys to every application and notebook is how key sprawl starts. Keys leak into code, get copied into environments, and become impossible to rotate without breaking something.

• One key for callers. Applications authenticate with a TrueFoundry key, not the provider key. As the docs put it, to access models through the gateway you use TrueFoundry API keys, not the original provider keys.
  

• Central rotation. Provider keys live in one place. Rotate them in the gateway and every application keeps working.
  

• Access control. You decide who can use which model account, with manager and user roles per account.
  

• One interface. Instead of managing separate SDKs, endpoints, and keys for OpenAI, Anthropic, Bedrock, and self-hosted models, applications talk to one gateway endpoint and use one gateway key.

Tired of provider keys scattered across your apps?

See how teams centralize every provider key behind one governed gateway. We will walk through your setup.

Book a demo

Adding your provider keys: model accounts

In TrueFoundry, a provider key lives inside a model account. The quick start docs describe a model account as one account of a model provider, for example OpenAI, Anthropic, or AWS Bedrock. You can add multiple accounts per provider, each with their own API keys, and each account can have multiple models.

To add one, select the provider you want, then add models after providing the API key. You can add multiple keys from the same provider by creating separate model accounts, which is useful when you want to separate spend or rate limits by environment or team.

‍

Once submitted, your model accounts and models appear under the Models tab. To add more later, go to AI Gateway, then Models, select a model account on the left, and click Add Model in the top right.

‍

Adding models to a model account after the provider key is stored.

‍

How callers authenticate: virtual keys

‍

Once your provider keys are stored, applications never see them. The gateway access control docs describe two token types that callers use instead.

‍

• Personal Access Tokens (PATs) are tied to a user and are recommended for developers during development.
• Virtual Account Tokens (VATs) are tied to a virtual identity and are recommended for production applications. This is the virtual key that your services ship with.

‍

Access is configured at the model account level with two roles. A Model Account Manager can modify settings, add or remove models, and manage access permissions. A Model Account User can use all models within the account but cannot change settings or permissions. Tenant admins automatically have access to all models across the platform.

‍

To call the gateway, you need three things from the Code Snippet tab of the Playground: the gateway base URL, an API key, and a model id. SaaS users point to the gateway base URL, authenticate with a PAT or VAT, and use the standard OpenAI client.

‍

The Playground Code Snippet tab, showing the gateway base URL and key your application uses.

‍

from openai import OpenAI

‍

client = OpenAI(

    api_key="your_truefoundry_api_key",

    base_url="https://gateway.truefoundry.ai",

)

‍