Skip to main content

​
Overview

BYOK (Bring Your Own Key) lets you connect your own provider API keys and use those models directly inside Verdent’s built-in agents.

​
BYOK vs BYOA

Verdent offers two “bring your own” paths—don’t confuse them:
BYOKBYOA
What you bringA provider API keyAn Agent runtime (Codex / Claude Code)
What runs your taskVerdent’s built-in agent, using the provider behind your keyThe external CLI agent on your machine
Typical use caseAccess a model under your own billing, or use a provider not bundled by defaultKeep your existing Codex / Claude Code workflow while letting Manager dispatch Worker tasks to it
Configure atSettings → Models → Configure ModelsSettings → Models → CLI Agents
See BYOA for running Worker tasks on an external Agent runtime.

​
Supported Providers

  • Anthropic
  • OpenAI
  • OpenRouter

​
Add an API Key

1

Open model configuration

Go to Settings → Models → Configure Models.
2

Start adding a key

Click Add API Key + in the top-right corner.
3

Choose provider and models

Select a provider and choose the models you want to enable.
4

Enter credentials

Add your API key.
5

Save and validate

Click Save. Verdent validates the key automatically.

​
Validation Results

  • If validation succeeds, the key is saved and the selected models become available.
  • If validation fails, Verdent shows an error so you can update the key and try again.

​
Manage Existing API Keys

Under Settings → Models → Configure Models, you can:
  • Enable or disable all models for a provider
  • Enable or disable individual models
  • Edit an existing API key
  • Delete an API key

​
Where BYOK Models Appear

After you add a valid key, BYOK models appear in:
  • The chat model selector
  • Preset model configuration
  • Subagent settings
  • Reviewer settings
BYOK models behave like built-in models once they are enabled.

​
Limitations

  • Built-in features such as Smart Suggestions do not support BYOK API keys.
  • Automatic compression does not support BYOK API keys.