BYOK Setup

Configure Bring Your Own Key (BYOK) with OpenAI, Anthropic, or Google API keys for additional debate capacity on AskVerdict.

2 min read
Share

Bring Your Own Key (BYOK) lets you use your own AI provider API keys for additional debate capacity beyond your monthly credits. Your keys are never stored - they exist only in memory for the duration of each request.

BYOK is available as a dedicated subscription: BYOK ($19/mo) for unlimited debates with your own keys, or BYOK Pro ($39/mo) which adds decision matrix, convergence scores, and advanced features.

Supported Providers

ProviderModels UsedHow to Get a Key
OpenAIGPT-4o, GPT-4o-miniplatform.openai.com/api-keys
AnthropicClaude 4, Claude 3.5 Sonnetconsole.anthropic.com
GoogleGemini 2.0, Gemini Proaistudio.google.com
DeepSeekDeepSeek V3, R1platform.deepseek.com
OpenRouter100+ models, one keyopenrouter.ai/keys
GroqUltra-fast inferenceconsole.groq.com

Step 1: Subscribe to a Paid Plan

BYOK requires a Starter or Pro subscription. Subscribe at askverdict.ai/settings?tab=billing.

Step 2: Get Your Provider Key

OpenAI

  1. Go to platform.openai.com/api-keys
  2. Click Create new secret key
  3. Copy the key (starts with sk-)

Anthropic

  1. Go to console.anthropic.com/settings/keys
  2. Click Create Key
  3. Copy the key (starts with sk-ant-)

Google

  1. Go to aistudio.google.com/apikey
  2. Click Create API Key
  3. Copy the key

Step 3: Use Your Key

Via Web App

  1. Go to Settings - Provider Keys
  2. Enter your API key for each provider
  3. Keys are stored in your browser only - never sent to our servers for storage

Via API Header

Pass your provider key with each request:

bash
curl -X POST https://api.askverdict.ai/v1/verdicts \
  -H "Authorization: Bearer vrd_your_api_key" \
  -H "X-Provider-Keys: openai:sk-your_openai_key" \
  -H "Content-Type: application/json" \
  -d '{"question": "...", "mode": "thorough"}'

Multiple providers:

bash
X-Provider-Keys: openai:sk-abc123,anthropic:sk-ant-xyz789

Via SDK

typescript
const client = new AskVerdictClient({
  apiKey: "vrd_your_key",
  providerKeys: {
    openai: "sk-your_openai_key",
  },
});

Security

BYOK keys are never stored on our servers. They are:

  • Transmitted over HTTPS (TLS 1.3)
  • Held in memory only during request processing
  • Discarded immediately after the AI provider responds
  • Never logged, cached, or written to disk

Troubleshooting

IssueSolution
BYOK_REQUIRED errorSubscribe to Starter or Pro first
PROVIDER_ERRORCheck that your provider key is valid and has credits
PROVIDER_TIMEOUTProvider is slow - try again or switch providers
Key not workingEnsure the format is correct: provider:key

Was this page helpful?