渠道管理
渠道(Channel) 是一个上游 AI 供应商的接入点。平台通过渠道把请求转发给真正的 AI 服务(OpenAI 兼容服务、Claude 服务等)。
渠道字段
| 字段 | 说明 |
|---|---|
| 名称 | 渠道显示名 |
| 类型 | openai 或 claude,决定与上游通信的协议 |
| BaseURL | 上游 API 基础地址 |
| APIKey | 调用上游所用的密钥 |
| 优先级(Priority) | 路由时数值越高/越靠前越优先(取决于路由算法) |
| 权重(Weight) | 加权路由时的权重 |
| 倍率(Multiplier) | 该渠道的计费倍率 |
| 用户渠道 | 该渠道归属的用户渠道(供给分层) |
| 启用状态 | 关闭后不参与路由 |
接入一个上游
- 新建渠道,选择类型(如
responses); - 填写上游
BaseURL与APIKey; - 选择/创建所属 用户渠道;
- 设置优先级、权重、倍率;
- 保存并启用。
接下来需要在 模型管理 把全局模型绑定到该渠道(创建 ModelConfig),渠道才能真正提供模型。
模型同步
平台支持从上游拉取可用模型列表,减少手工录入:
- 预览同步:拉取上级倍率的时候会先抓取上游模型清单,生成预览,确认后再应用;
- 从浏览器粘贴:在无法在后端拉取的情况下,支持把你在浏览器里拿到的上游响应体直接粘贴进来生成预览,适合上游有访问限制、服务器侧不便直连的情况;
- 应用同步:确认预览后点击确认写入;
- 价格同步:进入上游页面可以同步模型的价格。
平台还会启动一个后台同步循环,定期尝试同步价格(具体周期以实现为准,暂不可更改)。
渠道分组倍率
除了渠道自身的倍率,你还可以为「渠道 × 分组」设置更细的倍率,让不同分组的用户走同一渠道时承担不同价格。倍率如何合并见 分组与倍率。
上游密钥安全
渠道里保存的上游 APIKey 是高价值凭据。确保数据库文件与备份的访问受控,不要把它暴露给非管理员。