分组与渠道

分组是什么§

一个分组对应一个上游服务，里面装着一池凭据。 网关收到请求后，在这池凭据里挑一个可用的发出去；某个凭据限流或失效， 会自动避开它用别的，不需要你介入。

分组和访问密钥的分工见 核心概念。 简单说：分组朝上游，访问密钥朝应用。

35 个内置渠道§

建分组时从这些里选一个。常用渠道直接显示为按钮，其余渠道收在「其他渠道」中。 不同类别的凭据形态不一样：

每个渠道会声明自己能执行哪些协议和能力。 网关在支持的能力之间做转换，但它不是万能翻译器——边界见 协议与转换边界。

查看逐渠道支持矩阵 →

建一个分组§

点分组 → 新建分组。 要填的核心只有三样：渠道、凭据、模型。

查看大图

接几个上游就建几个分组。同一个服务商的多把密钥不用拆，放同一个分组里即可。

渠道参数§

已有 API Key 分组可在高级配置中切换到其他 API Key 渠道，无需重新导入凭据；订阅分组不支持这样切换。切换前确认目标渠道兼容现有凭据，并核对保留的自定义地址和模型配置。

选定渠道后，表单会出现这个渠道特有的参数。常见的几种：

• 接口地址——官方渠道有默认值，用中转或自建服务时才需要改
• 网关根地址——GPT-Load、New API、CLIProxyAPI、Sub2API 填根地址或部署前缀， 不要附加 /v1、/v1beta 或查询参数
• 区域——AWS Bedrock、Google Vertex AI 这类云平台要指定区域
• 部署名——Azure OpenAI 的模型部署标识

填错这些通常表现为请求全部失败。遇到时用 监控与排障 里的路由检查， 能看出哪些分组进入候选，以及当前有多少可用凭据。

管理凭据池§

凭据池是分组的核心。放几把密钥，网关就在几把之间轮转， 单把出问题不会影响整体。

查看大图

顶部按状态分类统计。可用的参与轮转，冷却中的暂时跳过，拉黑的已被自动摘除。

凭据可设置可选名称，便于在列表、日志和路由检查中识别；清空名称后恢复原有标识。名称仅用于展示，不修改密钥、账号身份、调度或健康状态。

订阅账号默认遮罩显示，可在凭据详情中显式展开。遮罩只减少界面上的信息暴露，不会删除账号信息，也不代表管理 API 中的账号字段已被脱敏。

凭据可以做这些操作：

• 批量导入——在分组的凭据页打开导入面板， 一次粘贴多把密钥，每行一个
• 启用／停用——停用后不参与轮转，但保留在池子里
• 单条权重——让某把密钥承担更多或更少流量
• 测试连接——用这一条凭据发一次最小的真实上游请求， 当场看它还能不能用
• 查看真实值——凭据加密存储，需要时可以显式查看
• 单独设代理——某把密钥需要走不同出口时用，见 代理与请求头

在 API Key 分组勾选多条凭据，点击「批量测试」，统一选择协议与模型；最多同时测试 10 条，可停止并重测失败或未完成项。离开分组会取消本轮测试。测试会发出真实请求，可能产生费用，不自动改变启停或拉黑状态。

分组与单条凭据的代理从「代理」页维护的已启用代理中选择，也可选择继承或直连。同一代理可被多处引用；修改地址会影响这些引用，停用或删除后则回退到上一级配置，最终可能直连。

API Key 分组还可在凭据页选择「全量操作 → 从文件导入」，一次选择多个 UTF-8 编码的 TXT、JSON 或 JSONL 文件，核对凭据数量后提交。每次最多 5,000 条凭据、32 MiB；文件内容仍须符合当前渠道的凭据格式。

查看大图

重复的密钥会被自动识别并跳过，可以放心整段粘贴。

开放哪些模型§

分组要声明它对外提供哪些模型。可以从上游自动发现， 也可以手工添加。

查看大图

只有列在这里的模型，才能通过这个分组被请求到。

模型别名就在同一张表里配置；价格与成本估算见 模型管理。

运行策略§

分组基础配置可设置优先级和权重；其他运行参数包括超时、拉黑阈值、会话亲和、出站代理与参数覆盖规则。

优先级默认 0，可为负数；越大越优先。可将主用设为 100、备用设为 0，同层再按路由策略和权重分配流量。重试降层规则见 失败之后。

查看大图

支持继承的参数可启用覆盖，或恢复系统默认；保存后生效。

各参数分别调什么、什么场景下该改，见 运行时设置。

「参数覆盖规则」可按客户端协议和模型匹配，模型支持精确匹配或末尾 * 前缀匹配。 命中的规则依次执行，每条先删除指定 JSON 路径，再合并设置；后面的规则覆盖前面的值。 对象递归合并，直接设置数组值时整体替换，null 是普通值。

对数组内的对象，可在 set 中用 * 逐项设置字段，在 remove 路径中用 * 逐项删除字段；只遍历已有元素，保留其他字段及数组顺序，不删除数组元素，也不支持数字索引。例如移除每条消息的 reasoning_content：

[{"remove":["/messages/*/reasoning_content"]}]

参数覆盖用于生成、Embeddings 与 Rerank 请求，不作用于图片编辑、Token 统计、Responses 资源操作或探测；不能修改根级 model、stream、store，也不能注入或改写 previous_response_id。

自定义渠道§

要接的服务不在内置列表里，但兼容 OpenAI 接口？选 OpenAI Compatible， 自己填接口地址和密钥即可。各类中转服务、自建的推理服务都走这个。

什么时候该拆分组§

该拆的情况：

• 对接不同的上游服务——这是硬性的，一个分组只能选一个渠道
• 同一服务商，但两批密钥要用不同策略（比如一批主用、一批兜底）
• 同一服务商，但要开放给不同应用的模型范围不同

不用拆的情况：同一个服务商的多把密钥。 直接放进一个池子，网关自己会轮转和避让，拆开反而失去了互为备份的效果。