Skip to content

Use your own API keys

By default, Forra calls AI models using its own API keys at the providers (OpenAI, Anthropic, Google, Azure, etc.). Usage is billed to your organization through Forra.

It is possible to use your own API keys for one or more providers, for example to:

  • Take advantage of a contract or rates negotiated directly with the provider.
  • Comply with a compliance requirement (data flows through your own provider account).
  • Isolate billing per project or department.

Prerequisites

  • An account at the model provider (e.g., OpenAI, Anthropic, Azure OpenAI).
  • A valid API key with access to the models you want to use.

Configure a key for a model

  1. Tenant Admin → Models tab.
  2. Find a model from the target provider in the selected-models list.
  3. Open its menu and choose Configure API key.
  4. Enter the new API key in the New API key field.
  5. (Optional) Check Apply to all {provider} models to use this key for every model from the same provider. Otherwise, it applies only to the open model.
  6. Save.

The key is applied immediately.

Remove a custom key

In a model's Configure API key panel, click Delete API key. Forra falls back to its default shared key.

Check key status

In the models list, a Custom API key label appears on models that use a key specific to your organization. Others use Forra's default key.

Notes

  • Entered keys are encrypted at rest.
  • If a key becomes invalid (revoked, expired), calls to the corresponding models will fail. Remove the key to fall back on Forra's key, or enter a new one.
  • For self-hosted providers or Azure OpenAI deployments with a custom endpoint, contact the Forra team — the current interface handles the key but not the endpoint URL.