后台日常管理

按步骤管理组织、渠道、Key、路由、用量和安全配置。

管理员任务指南更新于 2026-10-28

角色与准备

使用超级管理员完成平台级配置。超级管理员不属于组织;组织管理员属于一个组织,只能管理本组织的 Key 和私有渠道,已分配公共渠道只读。系统没有默认组织,后台账号与网关 Key 是不同凭据。

配置渠道和模型

  • 准备自有上游服务或具有访问资格的官方订阅账号。进入“渠道与模型”新建渠道,选择 API Key、上游代理或官方订阅(OAuth);订阅方式自动填写官方地址和协议。
  • 执行模型扫描,打开渠道的模型列表,核对模型 ID、启用状态及价格。扫描和能力元数据不等于实际调用成功。
  • 官方订阅支持 ChatGPT / Codex、Claude、Gemini CLI / Code Assist 和 Antigravity;完成登录、回填授权结果并保存后,再配置模型。确认上游支持所需协议、流式和工具调用,并用小请求分别验证。

创建组织并分配渠道

  • 超级管理员在“组织管理”新建组织,填写名称并设为 active;配置可用渠道和模型。
  • 打开“渠道关联”,明确分配公共渠道并启用关联;空公共渠道分配不代表可使用全部公共渠道。模型白名单留空时仍须满足其他授权条件。
  • 需要后台账号时,在“管理员配置”开通所属组织的 org_admin;新建组织不会自动创建管理员或 Key。

签发并验证 Key

  • 在“API 密钥”创建 Key,选择所属组织并按用途设置名称、预算和 IP 白名单;Key 属于组织,不绑定人员。
  • 渠道和模型限制留空时继承组织与渠道策略;“全选”保存的是当前明确列表,以后新增的模型不会自动加入。预算留空表示该层不设限,0 是零预算。
  • 保存时安全保存完整 Key,向使用者提供网关地址及授权模型。超级管理员在“设置 → API 地址”配置地址;为空时客户端导入不可用。
  • 使用该 Key 查询模型并完成一次调用,按时间和模型核对用量或错误记录。查看完整 Key、MFA 和客户端导入的具体流程应按部署版本验证。

路由、限流与预算

  • 直接模型调用验证通过后,超级管理员可在“智能路由”设置公开模型名称、协议、长短请求的渠道与模型,保存后分别验证;路由不能绕过组织和 Key 权限。
  • 在“限流与配额”设置全局、组织或 Key 的 QPS 和 Key 的滚动 Token 窗口。该 QPS 层的 0 表示不限速,仍受其他层限制;滚动窗口与日历周期预算不同。

用量、安全和通知

  • 按 Key、模型、时间及 Request ID 检查用量、请求链路和错误;缺失指标不等于零流量。
  • 安全规则先用 observe 和无害样例核对命中与误报,再按需启用 block;在安全审计中核对规则、动作和实际结果。
  • 消息 OTP 配置和安全事件 Webhook 是独立设置。管理员开通、验证码和 MFA 的完整流程需在实际部署中验证。

安装量遥测

安装量遥测默认关闭,由超级管理员在“系统设置 → 安装量遥测”主动开启或关闭。开启前查看页面显示的接收域名、字段、频率和保留说明;接收地址由构建配置固定,不能在管理页面修改。

报告包含安装身份、版本、操作系统与架构等最小字段,以及每日报告的日期和时区;不包含请求正文、Key 或业务用量。关闭遥测不关闭本地用量和网关功能;已送达接收方的数据不能由关闭操作撤回。

按部署版本核对具体能力与操作。 查看文档适用范围

BOS API · TYPEX

销售咨询暂不可用

暂时无法初始化销售接待,请稍后重试。你仍可查看文档并免费自托管。

查看文档免费自托管