Token 供应商配置
添加和配置上游 AI 服务商，为创建 API Key 提供模型能力支撑
说明：Token 供应商是提供 AI 模型服务的平台，如 Deepseek、阿里云百炼等。在创建 API Key 之前，需要先完成供应商配置。系统已内置 9 种主流供应商类型，选择类型后会自动填充对应的 API 地址。
供应商列表
登录 Tarogo AI 管理系统后，在左侧导航栏中选择「网关管理」→「Token 供应商」，进入供应商管理列表页面。
图 1：Token 供应商管理列表页面
列表字段说明
| 字段 | 说明 |
|---|---|
| Token 供应商名称 | 用户自定义的供应商名称，如「阿里云-Qwen」「公司 Deepseek 统一账号」 |
| 供应商类型 | 以蓝色标签展示，如 Deepseek API、阿里云百炼 - 北京 API、Kimi API 等 |
| 状态 | 绿色标签表示「正常」，灰色标签表示「禁用」 |
| Model | 该供应商支持的模型列表，前 2 个直接展示，剩余以 +N 标签折叠，点击可查看全部模型 |
| 使用方式 | 调用模型时，在 model 参数中使用 模型名@供应商类型 格式即可指定供应商。 示例： "model": "qwen3.7-max-preview@aliyun-beijing" |
| 优先级 | 数字越小优先级越高，默认 100。如果调用时未通过 @供应商类型 指定供应商，且该模型存在多个供应商时，系统会按优先级自动选择。 |
| 个人 Key | 绿色标签表示「支持」，灰色标签表示「不支持」。开启后，用户可在个人中心通过「自主创建 Key」功能为该供应商一键生成个人 Key |
| 操作 | 支持编辑、启用/禁用、删除操作 |
搜索与筛选
列表上方提供了搜索和筛选功能，支持按以下条件过滤供应商：
- 名称搜索：输入供应商名称关键字，按回车搜索
- 类型筛选：按供应商类型下拉筛选
- 状态筛选：筛选「正常」或「禁用」状态的供应商
- 点击「重置」按钮可清空所有筛选条件
添加供应商
打开添加表单
点击列表页面右上角的「添加供应商」按钮，从右侧滑出抽屉式表单窗口。
填写供应商信息
在添加供应商表单中，需要填写以下信息：
| 字段 | 必填 | 说明 |
|---|---|---|
| Token 供应商名称 | 是 | 2-50 个字符，如「阿里云-Qwen」「公司 Deepseek 统一账号」 |
| 供应商类型 | 是 | 下拉选择，选中后自动填充对应的 API 地址（Base URI）。内置类型：Deepseek API、阿里云百炼（北京/新加坡）、Kimi、火山方舟、MiniMax、GLM 智谱、硅基流动、腾讯云 |
| API Key | 是 | 从供应商平台获取的 API Key，长度至少 10 个字符。AI Gateway 将使用此 Key 与上游供应商通信 |
| 使用优先级 | 否 | 数字越小优先级越高，默认 100。当同一模型存在多个供应商时，系统优先调用优先级最高的供应商（即数值最小的） |
| 允许个人 Key | 否 | 开关按钮，默认开启。开启后，用户可在个人中心通过「自主创建 Key」功能为该供应商一键生成个人 Key。关闭后该供应商不会出现在用户自主创建的可用列表中 |
确认添加
填写完所有必填信息后，点击「确定」按钮，系统将验证 API Key 并保存供应商配置。添加成功后，新供应商会出现在列表中，状态显示为「正常」。
填写供应商信息
图 2：添加供应商表单，填写供应商名称、类型、API Key 和使用优先级
编辑供应商
进入编辑模式
在供应商列表的操作列中，点击「编辑」按钮，从右侧滑出编辑抽屉。编辑表单与添加表单字段一致，API Key 字段会显示为脱敏形式，如需修改请输入新的完整 Key。
编辑模式高级功能
编辑模式下，表单底部提供以下批量操作按钮：
- 同步模型列表：从供应商 API 拉取最新模型列表并更新到系统中。当供应商平台新增或下架模型时，使用此功能同步。
- 一键同步到所有 Key：将该供应商添加到当前账号下所有 API Key 的允许供应商列表中。适用于新增供应商后需要批量授权的场景。
- 一键从所有 Key 清除：将该供应商从当前账号下所有 API Key 的允许供应商列表中移除。适用于供应商下线或需要批量回收权限的场景。
进入编辑模式
图 3：编辑供应商表单，支持同步模型列表、一键同步/清除到所有 Key
自定义 AI Token 供应商类型
除了系统内置的标准供应商类型（如 Deepseek API、阿里云百炼等），租户管理员还可以在「系统设置」→「其它配置」→「自定义AI Token供应商类型」中创建自定义供应商类型。
创建自定义供应商类型
在「其它配置」页面点击「新增」按钮，弹出创建窗口，需要填写以下信息：
- 供应商名称：自定义的显示名称
- 供应商类型：类型标识，用于在 model@类型 格式中指定路由
- API 请求地址：该供应商的 API 端点地址，支持任意 URL
使用场景
- 非标准 API 兼容：部分三方服务虽兼容 OpenAI 协议但不在系统内置列表中
- 企业私有部署：企业内部自建的模型服务，通过自定义类型注册后统一通过网关管理
- 代理转发：将请求转发到自定义的代理地址
创建自定义供应商类型
图 4：在其它配置中创建自定义 AI Token 供应商类型
注意：如果填写的 API 请求地址不是 OpenAI 标准 chat/completions 格式，系统会弹出确认提示，确认后仍然可以创建。
启用/禁用与删除
- 启用 / 禁用：在操作列点击「禁用」可将供应商临时停用，停用后的供应商不会参与 Key 的调用路由。
- 删除：在操作列点击「删除」可移除供应商配置。删除操作不可恢复，操作前会有确认弹窗。