BYOK（自带 API Key）
连接你自己的 OpenAI / Anthropic / Google / DeepSeek / Qwen / Moonshot / xAI / Mistral API Key——使用 BYOK 时不消耗 VizChat 平台积分。
BYOK（Bring Your Own Key）是 VizChat 最核心的差异化能力之一。你可以直接把自己的第三方大模型 API Key 填进设置，让 VizChat 以"你的账户"去调用模型——这样既不消耗 VizChat 平台积分，也让你对成本、模型版本、数据流完全可控。
为什么要用 BYOK
- 不消耗平台积分：BYOK 调用产生的费用由你在对应 provider 的账户承担，VizChat 不收取任何中间费用；
- 访问最新模型：有些前沿模型（如刚发布的 reasoning 模型）可能还没上架到平台托管池，但你自己的 API Key 立刻可用；
- 合规 / 数据边界：企业场景下，部分客户要求对话数据必须直连他们自签的 provider，BYOK 天然满足；
- 成本控制：你自己谈的企业折扣、月度额度、提示词缓存，都直接生效。
套餐支持矩阵
| 套餐 | BYOK 支持 |
|---|---|
| Free（免费版） | 不支持 |
| Starter | 支持 |
| Pro | 支持 |
| Max | 支持 |
Starter 是专门为 BYOK 场景设计的入门档——即使月度积分与 Free 相同，但解锁 BYOK 就可以用你自己的 Key 无限调用。
支持的 Provider（8 个）
VizChat 目前支持以下 8 个主流模型 provider：
| Provider | 典型模型 | 填入位置 |
|---|---|---|
openai | GPT-4o, o1, o3 | Settings → BYOK → OpenAI |
anthropic | Claude Opus / Sonnet / Haiku | Settings → BYOK → Anthropic |
google | Gemini 2.x Pro / Flash | Settings → BYOK → Google |
deepseek | DeepSeek-V3, DeepSeek-R1 | Settings → BYOK → DeepSeek |
qwen | Qwen3 系列 | Settings → BYOK → Qwen |
moonshot | Kimi K2 系列 | Settings → BYOK → Moonshot |
x-ai | Grok 系列 | Settings → BYOK → xAI |
mistralai | Mistral Large / Medium / Small | Settings → BYOK → Mistral AI |
Provider ID 的命名与 OpenRouter 的 prefix 保持一致，便于多供应商切换。
配置步骤
- 访问 Settings → BYOK 页面；
- 找到你要配置的 provider，点击"添加 Key"；
- 粘贴你的 API Key（平台会立即加密存储，仅保留解密用于后端构建 LiteLLM 请求）；
- 保存后，Key 会被展示为掩码形式（如
sk-****...abcd），你随时可以更新或删除； - 在对话模型选择器里，选择对应 provider 的模型 → 自动切换为你的 Key。
安全与加密
- 所有 Key 使用 Fernet 对称加密存储在数据库（
encrypt_api_key）； - 仅在后端构建 LiteLLM 客户端的瞬间解密；
- 列表接口（
/api/user-api-keys）只返回掩码，永远不泄漏明文； - 删除 Key 是物理删除，立即生效。
计费透明度
使用 BYOK 调用模型时：
- VizChat 侧：不扣任何平台积分；
- Provider 侧：按你的账单计费（OpenAI token 价格、Anthropic prompt cache 折扣等全部生效）；
- 混合使用：一个账号下既可以用 BYOK 模型，也可以用平台托管模型，每次对话独立计费。