场景指南
场景指南
按真实产品场景选择接入方式,而不是按内部实现细节阅读。
这些指南不是 API 参考,而是“在什么场景下应该怎么用 VisibleBase”。
如果你已经理解了基本概念,但开始接真实产品、真实用户和真实 provider,这一组文档会更有用。
按场景选入口
纯客户端产品
适合先只写前端、插件或 App 的产品。理解为什么不需要为每个新想法都重搭一套 AI 后端。
多产品共用 Base一个 Base 如何同时服务多个产品,以及 product_id 和 token metadata 应该如何组织。
把登录、签 token、前端调用三段链路接起来,避免把管理能力泄漏到终端。
provider 环境变量如何管理上游 provider key、Base URL 和运行时环境变量。
模型路由如何通过 default() 和 match() 让同一个 service 在不同 provider 之间分流。
把套餐、余额、扣费、日志和风控接进 Base,但不把业务系统搬进 Base。
推荐顺序
- 如果你在做新产品,先看 纯客户端产品
- 如果你已经有多个产品,接着看 多产品共用 Base
- 如果你要开始接真实用户,再看 鉴权与 user_token
- 如果你要开始接真实 provider,再看 provider 环境变量 和 模型路由