BYOK（自带 API Key）
连接你自己的 API Key（15 家 provider，含 OpenRouter 聚合器与任意 OpenAI 兼容服务）——使用 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（15 个）
VizChat 目前支持以下 15 个 provider：
| Provider | 典型模型 |
|---|---|
openai | GPT-4o, o1, o3 |
anthropic | Claude Opus / Sonnet / Haiku |
google | Gemini 2.x Pro / Flash |
deepseek | DeepSeek-V3, DeepSeek-R1 |
qwen | Qwen3 系列 |
moonshotai | Kimi K2 系列 |
x-ai | Grok 系列 |
mistralai | Mistral Large / Medium / Small |
cohere | Command R / R+ |
perplexity | Sonar 系列 |
openrouter | 全目录（一个 Key 通所有模型，含 Llama / Nvidia 等） |
groq | 自填模型名（超低延迟推理） |
together | 自填模型名（开源模型托管） |
fireworks | 自填模型名（开源模型托管） |
custom | 自建 / 未收录服务（填地址 + 模型名，须公网可达） |
Provider ID 的命名尽量与 OpenRouter 的 prefix 保持一致，便于多供应商切换。
最后三家是推理服务商——它们跑的是别人的开源模型，没有「自家模型」这个维度，所以模型名由你填（照抄该平台文档里的写法）。OpenRouter 是聚合器，一个 Key 就能路由全目录。
配置步骤
- 访问 设置 → 自定义模型；
- 找到你要配置的 provider，点击"添加 Key"；
- 粘贴你的 API Key——平台会立即加密存储，明文密钥不会离开服务端；
- 保存后，Key 会被展示为掩码形式（如
sk-****...abcd），你随时可以更新或删除； - 在对话模型选择器里，选择对应 provider 的模型 → 自动切换为你的 Key。
模型能否读图
AI 检查组件与作品时会截图看效果，截图只附给能读图的模型。大多数 provider 的模型能否读图由平台按公开模型表自动判断； Groq、Together AI、Fireworks AI 与「其他（OpenAI 兼容）」的模型名由你自己填，平台查不到，配置 Key 时勾选 这里的模型能读图 即可。 勾错了也不要紧：某个模型实际不收图片时，平台会自动对它退回文字报告。
安全与加密
- 所有 Key 以 AES-256-GCM 加密存储在数据库；
- 仅在真正用到 Key 的那一刻才会在服务端解密——发起模型请求时，或计算设置页展示的掩码时——用完即弃；
- 列表接口（
/api/user/api-keys）只返回掩码，永远不泄漏明文； - 删除 Key 是物理删除，立即生效。
计费透明度
使用 BYOK 调用模型时：
- VizChat 侧：不扣任何平台积分；
- Provider 侧：按你的账单计费（OpenAI token 价格、Anthropic prompt cache 折扣等全部生效）；
- 混合使用：一个账号下既可以用 BYOK 模型，也可以用平台托管模型，每次对话独立计费。