# Bring Your Own Key

Create or edit an agent, switch its model source to BYOK, select the provider and model, add or choose the key, save, and verify provider-side usage.

![Bring Your Own Key in Foxora v5.0.3](/docs/images/v5.0.3/settings/models.webp)

## Where this lives

Open **Settings → Models**.

Foxora provides managed model access through subscription credits and also supports BYOK. A BYOK provider key is assigned to a particular agent, so that agent uses the selected provider and model instead of Foxora-managed credits for those calls.

> **Safety:** Add API keys only through the dedicated agent or provider controls. Never include keys in agent instructions, task prompts, project files, screenshots, or support bundles.

## Steps

1. Open **Settings → Models**.
2. Create or edit an agent.
3. Switch its model source to BYOK.
4. Select the provider and model.
5. Add or choose the key.
6. Save.
7. Verify provider-side usage.
8. **Confirm the result.** Run a known prompt with the configured agent, inspect the effective model and usage record, and confirm whether Foxora credits or the provider account was charged.

## Choose the right path

- Use managed models for the simplest setup and Foxora credit accounting.
- Use BYOK for a supported provider model billed by that provider.
- Choose Fast, Premium, or Max processing according to task complexity and plan access.


## Confirm it worked

- Run a known prompt with the configured agent, inspect the effective model and usage record, and confirm whether Foxora credits or the provider account was charged.
- The screen, command, file, run, or destination named in this guide reflects the expected state.