Skip to main content

What is BYOK?

Bring Your Own Key (BYOK) allows you to use your own API keys from various AI model providers with Eigent. Instead of relying on a shared service, you connect directly to providers like OpenAI, Anthropic, or Google using your personal API credentials. This gives you:
  • Full control over your API usage and billing
  • Direct access to the latest models from each provider
  • Privacy - your requests go directly to the provider

OpenAI Configuration (Example)

Step 1: Get Your API Key

  1. Visit the OpenAI API Keys page
  2. Click “Create new secret key”
  3. Copy the generated key (you won’t be able to see it again)

Step 2: Configure in Eigent

  1. Launch Eigent and go to Settings > Models
  2. Find the OpenAI card in the Custom Model section <img src=“/images/Screenshot2026-01-20at18.13.45.png” alt=“Screenshot 2026 01 20 At 18 13 45” title=“Screenshot 2026 01 20 At 18 13 45” className=“mr-auto” style= />
  3. Fill in the following fields:
FieldValueExample
API KeyYour OpenAI secret keysk-proj-xxxx...
API HostOpenAI API endpointhttps://api.openai.com/v1
Model TypeThe model you want to usegpt-4o, gpt-4o-mini
  1. Click Save to validate and store your configuration
  2. Click Set as Default to use this provider for your agents

Configuration Fields

FieldDescriptionRequired
API KeyYour authentication key from the providerYes
API HostThe API endpoint URLYes (pre-filled for most providers)
Model TypeThe specific model variant to useYes
External ConfigProvider-specific settings (e.g., Azure deployment name)Only for certain providers

Azure-Specific Fields

FieldDescriptionExample
API VersionAzure OpenAI API version2024-02-15-preview
Deployment NameYour Azure deployment namemy-gpt4-deployment

Common Errors

When saving your configuration, Eigent validates your API key and model. Here are the errors you may encounter:
ErrorCauseSolution
Invalid key. Validation failed.API key is incorrect, expired, or malformedDouble-check your API key. Regenerate a new key if needed.
Invalid model name. Validation failed.The specified model does not exist or is not available for your accountVerify the model name is correct. Check if you have access to that model.
You exceeded your current quotaAPI quota exhausted or billing issueCheck your provider’s billing dashboard. Add credits or upgrade your plan.

Supported Providers

Eigent supports the following BYOK providers:
ProviderDefault API HostOfficial Documentation
OpenAIhttps://api.openai.com/v1OpenAI API Docs
Anthropichttps://api.anthropic.com/v1/Anthropic API Docs
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/Gemini API Docs
OpenRouterhttps://openrouter.ai/api/v1OpenRouter Docs
Qwen (Alibaba)https://dashscope.aliyuncs.com/compatible-mode/v1Qwen API Docs
DeepSeekhttps://api.deepseek.comDeepSeek API Docs
Minimaxhttps://api.minimax.io/v1Minimax API Docs
Z.aihttps://api.z.ai/api/coding/paas/v4/Z.ai Platform
Azure OpenAI(user-provided)Azure OpenAI Docs
AWS Bedrock(user-provided)AWS Bedrock Docs
OpenAI Compatible(user-provided)For custom endpoints (e.g., xAI, local servers)

Tips

  • Keep your API key secure - Never share or expose your API key publicly
  • Monitor usage - Check your provider’s dashboard regularly to track costs
  • Use appropriate models - Different models have different capabilities and pricing