BYOK (Bring Your Own Key)
Connect your own OpenAI / Anthropic / Google / DeepSeek / Qwen / Moonshot / xAI / Mistral API key — BYOK calls do not consume VizChat platform credits.
BYOK (Bring Your Own Key) is one of VizChat's core differentiators. You can plug your own third-party LLM API key into Settings, and VizChat will call models as your account — meaning BYOK usage does not consume VizChat platform credits, and you retain full control over cost, model version, and data flow.
Why BYOK
- No platform credits consumed: BYOK usage is billed to your provider account; VizChat adds zero markup;
- Access cutting-edge models: freshly released models (e.g., a brand-new reasoning model) may not yet be on the platform's hosted roster, but your own key works immediately;
- Compliance / data boundary: enterprise customers who require conversation data to flow only to their signed providers are natively supported;
- Cost control: enterprise discounts, monthly quotas, and prompt caching you negotiated apply directly.
Plan support
| Plan | BYOK |
|---|---|
| Free | Not supported |
| Starter | Supported |
| Pro | Supported |
| Max | Supported |
Starter is designed specifically for BYOK users — even though its monthly credits match Free, unlocking BYOK lets you run unlimited calls against your own key.
Supported providers (8)
VizChat currently supports these 8 mainstream providers:
| Provider | Typical models |
|---|---|
openai | GPT-4o, o1, o3 |
anthropic | Claude Opus / Sonnet / Haiku |
google | Gemini 2.x Pro / Flash |
deepseek | DeepSeek-V3, DeepSeek-R1 |
qwen | Qwen3 series |
moonshotai | Kimi K2 series |
x-ai | Grok series |
mistralai | Mistral Large / Medium / Small |
Provider IDs match the OpenRouter prefix convention for easy multi-provider switching.
Setup steps
- Go to Settings → Custom Model;
- Find the provider you want, click "Add key";
- Paste your API key — the platform encrypts it immediately, and the plaintext key never leaves the server;
- After saving, the key shows in masked form (e.g.,
sk-****...abcd); you can update or delete at any time; - In the conversation's model selector, pick a model from that provider — it auto-uses your key.
Security & encryption
- All keys are encrypted at rest with AES-256-GCM;
- The key is decrypted server-side only when it's actually used — to send a request through your provider, or to compute the masked preview shown in Settings — and only for that instant;
- The list endpoint (
/api/user/api-keys) returns masked values only — plaintext is never exposed; - Deletion is a hard delete and takes effect immediately.
Billing transparency
When you use BYOK to call a model:
- VizChat side: zero platform credits deducted;
- Provider side: billed per your provider's rates (OpenAI token prices, Anthropic prompt cache discounts, etc. all apply);
- Mixed usage: within one account, you can mix BYOK models and platform-hosted models freely; each call is billed independently.
Next step
Slash commands
Type "/" in the chat input to open a shortcut menu — help, keyboard shortcuts, validate the current document, clear the message list, and more.
Agent actions
What the VizChat agent can actually do — edit your document, find and build widgets, read workspace files, search the web, and run code.