Skip to main content

账号池

1 概述​

账号池是系统集中管理模型账号的入口。系统在调用大模型能力时，需要依赖各模型服务商提供的账号与凭证（如 DeepSeek、智谱、通义等大语言模型，以及阿里云、腾讯云等向量模型服务）。账号池将这些账号统一收纳到同一页面进行管理，避免账号分散、遗漏或重复配置。通过账号池，管理员可以集中查看所有已接入的模型账号，并完成账号的新增、编辑与删除等维护操作，为后续的并发控制、健康监测等能力提供统一的账号基础。

账号池列表
图 1 账号池列表

在账号池页面，你可以完成新增账号、编辑账号、启用 / 禁用账号、删除账号以及按供应商 / 状态 / 类型等维度筛选查看等操作。

2 账号池管理​

点击页面左上角「添加账号」按钮，在弹出的表单中依次完成以下配置：

2.1 添加账号​

2.1.1选择供应商与协议类型

在 供应商 下拉框中选择目标供应商。若供应商提供多种账号类型，还需继续选择按量付费、Coding Plan、Token Plan 等类型。

供应商下拉
图 2 供应商下拉

在 协议类型 处选择账号承载的协议类型，支持三种：

  • 文本：用于文本对话类模型；
  • 文生图：用于图片生成类模型；
  • 向量：用于向量 Embeddings 类模型。
添加账号表单
图 3 添加账号表单

2.1.2填写账号名称、服务地址与 API Key

完成供应商与协议类型选择后，继续填写以下基础信息：

  • 名称：账号在 1Panel AI 网关中的显示名称；
  • 服务地址：固定端点由系统根据供应商自动提供；自定义端点则需填写有效的 HTTPS / HTTP 地址；
  • API Key：供应商提供的访问密钥。凭据编辑时留空表示沿用已保存的 API Key。
DeepSeek 账号表单
图 4 DeepSeek 账号表单

2.1.3选择协议配置

系统会根据所选供应商与协议类型，列出可选的协议配置项（如 openai-completions、openai-responses、anthropic-messages 等），请根据上游账号的实际接入方式选择匹配的协议，并核对认证方式是否正确，确保后续可正常建立连接。

自定义供应商表单
图 5 自定义供应商表单

2.1.4配置模型映射

模型映射 用于建立客户端请求模型名称与供应商侧上游模型名称之间的对应关系。添加或编辑账号时，在模型映射区域填写：

  • 请求模型名称：客户端实际请求的模型名称；
  • 上游模型名称：调用供应商接口时使用的模型名称。
模型映射
图 6 模型映射

一个上游账号至少保留一个模型映射，最多支持 100 个。同一账号内的请求模型名称不能重复。若需要获取供应商侧最新模型列表，可在表单中单击 发现模型，系统将供应商返回的模型与当前映射进行比较，方便快速补全。

2.1.5设置调度参数

在「调度」区域设置账号的优先级与最大并发：

  • 优先级：数值越小优先级越高，多个可用账号并存时优先选择。

  • 最大并发：账号可同时处理的最大请求数，用于控制对上游的负载。

调度参数
图 7 调度参数

填写完成后单击 保存。保存时，文本和向量账号在创建或关键连接信息变更后会执行最小调用验证；文生图账号保存时不会实际生成图片。

2.2 编辑、启停与删除​

在账号池列表的操作列，可对每个账号执行以下操作：

  • 编辑：修改名称、凭据、地址、协议路由、模型映射、验证模型、优先级、最大并发和备注。
  • 启用 / 禁用：通过列表中的开关控制账号是否参与调度。
  • 删除：单击删除并确认后，账号及其模型映射将被移除。若账号正被向量服务等功能引用，则不能直接删除。
  • 筛选：可按供应商、协议类型、具体协议、状态和关键字筛选，并选择显示模型、优先级、最大并发等列。

3 注意事项​

  • 妥善保管密钥：勿在文档、截图或对话中明文展示 API Key，防止泄露。

  • 慎改在用账号：编辑或禁用正在调度的账号，可能立即影响模型调用。

  • 合理设置调度参数：优先级过低或并发过小，可能导致账号难被选用或请求积压。

  • 确保模型映射正确：映射有误时请求将无法路由到目标模型。

  • 留意健康状态：发现账号异常或成功率下降时，及时检查上游连通性、配额与凭证。

  • 删除前谨慎确认：删除为不可逆操作，确认账号不再被使用后再执行。

  • 示例数值仅供参考：文中账号、密钥、地址及统计数值均为示例。