接入第一个模型（BYOK）

一站通不自带模型、也不代付任何调用费用。所有 AI 能力都来自 你自己接入的模型——这就是 BYOK（Bring Your Own Key，自带密钥）。本页带你接入第一个模型，几分钟即可让对话真正跑起来。

为什么是 BYOK

特点	对你的意义
用你自己的账号与密钥	用哪家模型、花多少钱由你掌控，不经过任何中间代付
数据自持	AI 请求由本机直连你接入的模型服务，不绕运营方后端
密钥本地加密	你的 API Key 只存在本机、加密保存，明文绝不外传

你需要先准备好一个模型服务

接入前，请先在你选用的模型平台拿到 API 端点地址与 API Key。一站通支持 OpenAI 兼容与 Anthropic 两类协议，主流模型服务大多可归入其一。

新建一个模型（供应商接入）

进入 设置 → 供应商接入（模型广场），新建一个模型服务（Provider），按下表填写：

字段	说明
名称	自己起个好认的名字，如"我的 OpenAI""公司代理"
协议	选 OpenAI 兼容 或 Anthropic，按你的服务对应协议选
API 端点	服务的接口地址；留空时会按协议智能补全常见路径
API Key	你在该平台申请到的密钥

填好端点与 Key 后，可点击"拉取模型"自动获取该服务下可用的模型列表；若服务不支持列举，也可以手动填写模型名。最后把常用的一个设为 默认模型，对话时就会默认用它。

建议先"测试连接"

保存前先测试一次连接，确认端点与 Key 无误。若连接失败，多半是端点地址或 Key 有误、或该服务协议选错，按提示核对即可。

你的 API Key 是怎么被保护的

一站通对密钥的处理有明确红线：

• 加密入库：填写的明文 Key 在保存那一刻立即加密存储，本地数据库里不留明文；
• 只显掩码：界面与配置里只显示打码后的 Key（如 sk-***…***），完整明文不会回显到前端；
• 不外传：明文只在本机向你的模型服务发起请求时内部使用，不进日志、不随分享导出。

更新时把 Key 一栏留空，则保留原有密钥、不会被清空。完整机制见 BYOK 密钥安全。

一类模型≠全部能力：按模态接入

一站通能做的远不止聊天——还能生图、生视频、配音等。不同能力需要不同类型（模态）的模型，接入文本对话模型并不等于自动拥有生图或生视频能力。

用到某种能力却没接对应模型，会明确报错引导

比如你让它"生成一张封面图"，但只接入了文本模型，一站通不会静默失败或拿文本模型硬顶，而是会明确提示"当前没有可用的生图模型"，并引导你去模型广场接入对应模态的模型。生视频、配音同理。

因此建议按需求把对应模态的模型都接上：

你想做的事	需要接入的模型类型
对话、写作、翻译、总结	文本模型
生成图片、封面、海报配图	生图模型
生成视频	视频模型
配音、朗读	语音（音频）模型

多模态的整体说明见 多模态能力，模型的管理与切换见 模型管理。

下一步

接好至少一个模型后，就可以试着 第一次对话出成品 了。