New API 手册 / 管理员:渠道与用户

管理员:渠道与用户

面向管理员的后台配置说明。普通用户无需操作本章。

渠道(Channel)

渠道是"一条通往某上游的连接"。新增渠道需要:

字段说明
类型上游供应商类型(OpenAI / Anthropic / Gemini / Azure / 自定义中转等)
Base URL上游接口根地址(部分类型可留空用默认)
密钥上游发放的 API Key
模型该渠道支持的模型名单,或映射关系(对外名 → 上游名)
分组该渠道服务于哪些分组
权重 / 优先级同名多渠道时的分流与优先顺序
# 典型:新增一个 OpenAI 渠道
类型: OpenAI
Base URL: https://api.openai.com
密钥: sk-上游key
模型: gpt-4o-mini,gpt-4o
分组: default
注意
渠道密钥为高敏感信息,仅管理员可见,切勿截图外泄。渠道异常会直接影响对应模型可用性。

模型映射

若上游模型名与对外暴露名不同,可在渠道里做映射,例如对外叫 gpt-4o-mini,上游实际是 gpt-4o-mini-2024-xx。这样对外保持稳定命名。

用户与分组

  • 用户:可创建/封禁、调整额度、设为管理员。
  • 分组:决定可见模型与费率,令牌归属某分组。
  • 令牌:管理员可代查、禁用异常令牌。

系统设置

  • 站点名称、注册开关、是否允许邮箱注册。
  • 全局默认额度、速率限制策略。
  • 公告与首页展示内容。

渠道健康与故障切换

网关会探测渠道可用性;某渠道失败时可自动或手动禁用,让流量切到同名其它渠道。建议同名模型至少配两个健康渠道做冗余。

备份

对象说明
数据库用户/令牌/渠道/日志等,定期备份(Postgres 或内置库)
配置渠道与系统设置导出
密钥上游 Key 妥善保管,勿明文散落