VisibleBase 文档
一个 Base，让多个 AI 产品不再重复搭后端。
VisibleBase 是一个给 AI 产品准备的共用 AI ServerBase，也是一个面向多个产品复用的共用后端底座。
你先部署一个自己的 Base。以后做网页、插件、App、桌面工具、客户 Demo 或内部工具时，都可以直接接入它，不用每个 AI 产品都重搭一套 AI 后端。
它对外暴露的不是 provider API，而是产品调用边界：
- 产品侧拿到
product_id + user_token - 用
UserClient调text()、stream()、image()这类 service - Base 内部自己决定模型目录、provider 路由、hooks、usage 和 env
先选你的阅读入口
Start Here我想先跑通
最短路径部署一个 Base，写入模型，签发 token，让产品端成功调到 text() 或 stream()。
先分清 Base、产品前端、业务后端、AI Gateway 和真实 provider 分别负责什么。
Real Scenarios我已经在接真实产品看纯客户端产品、多产品复用、鉴权、provider env、hooks 和商业逻辑的真实使用方式。
API我只想查接口按角色直接看 Base、UserClient、AdminClient、HTTP API 和环境变量说明。
一张图看懂它怎么工作
多个产品 client网页、插件、App、桌面工具、客户 Demo、内部工具。
UserClient + product_id + user_tokenVisibleBase Base校验 token，读取模型目录，合并 service 的 query fallback，再通过
match() 路由真实调用。hooks 与 usage把套餐、余额、扣费、日志、风控接进 Base，但业务规则仍然留在你自己的系统里。
上游调用层OpenAI、Claude、Gemini、私有模型，或你自己的 AI Gateway / 中转服务。
对产品来说，Base 暴露的是稳定的 service 和 model；上游接什么 provider、网关或私有部署，都是 Base 内部细节。
Base 负责什么
products、models这组 Runtime 默认数据库- provider key 和 Runtime env
user_token校验与admin_secret_key管理能力service.default()提供 query fallbackservice.match()按ctx.query + ctx.model分流 handler- usage 记录和 hooks 扩展点
Base 不负责什么
- 你的用户系统
- 订单、订阅、CRM、内容数据
- 产品自己的页面、交互和业务体验
- 对外暴露“统一 provider API”给其他系统直接调用
更准确地说：
Base 负责 AI 调用这层共用基础设施。
产品继续负责自己的用户、业务、界面和商业模式。
推荐阅读路线
- 第一次接入，先去 快速开始
- 想彻底理解这个产品模型，再看 理解 VisibleBase
- 准备接真实业务，再看 场景指南
- 需要具体接口时，再回到 参考