模型与供应商
读完你能：在「用慧AI」和「自带 Key」两条路线里选对一条，并把模型平台配好、验好。
1. 两条配模型路线
Section titled “1. 两条配模型路线”入口：设置 → 模型
| 路线 | 适合谁 | 你要做什么 |
|---|---|---|
| 用慧AI | 拿到慧AI 登录令牌的用户 | 在 必要配置 保存令牌即可，模型页会自动出现慧AI 配置，无需手动添加 |
| 自带 Key | 自己有各平台 API Key 的用户 | 在本页手动添加平台和 Key，流程见第 3 节 |
用慧AI：保存令牌就能聊
到「设置 → 必要配置」粘贴并保存慧AI 登录令牌，软件会自动在模型页创建慧AI模型配置（deepseek-v4-flash / x-preview-f-free / gpt-5.6-terra）并更新密钥，开箱即聊。
自带 Key：本页手动添加
点右上角「添加模型」选「手动添加」，选平台、填 API Key、选模型，两三分钟配好。多把 Key 可以轮询使用。
2. 支持的平台
Section titled “2. 支持的平台”添加平台时，下拉列表按下面的顺序展示：「自定义」排在第一位，Kimi（Moonshot）紧随其后置顶，然后是官方直连与各预设供应商。列表以应用内为准。
| 平台 | 地区 | 说明 |
|---|---|---|
| 自定义（Custom） | 不限 | 没有预置地址，需自己填 API 请求地址 |
| Moonshot (China) | 国内 | Kimi 中国版 |
| Moonshot (Global) | 国际 | Kimi 国际版 |
| New API | 不限 | 聚合网关，可按模型选请求协议 |
| Gemini | 国际 | Google 官方平台 |
| Gemini (Vertex AI) | 国际 | Google Vertex AI 通道 |
| OpenAI | 国际 | GPT 系列 |
| Anthropic | 国际 | Claude 系列 |
| AWS Bedrock | 国际 | 亚马逊云模型托管 |
| DeepSeek | 国内 | — |
| MiniMax | 国内 | — |
| Novita | 国际 | — |
| OpenRouter | 国际 | 聚合网关 |
| Dashscope | 国内 | 阿里云通义 |
| Dashscope Coding Plan | 国内 | 通义编码套餐，需自填套餐端点 |
| SiliconFlow-CN | 国内 | 硅基流动 |
| SiliconFlow | 国际 | 硅基流动国际版 |
| Zhipu | 国内 | 智谱 |
| xAI | 国际 | Grok 系列 |
| Ark | 国内 | 火山方舟 |
| Qianfan | 国内 | 百度千帆 |
| Hunyuan | 国内 | 腾讯混元 |
| Lingyi | 国内 | 零一万物 |
| Poe | 国际 | 聚合平台 |
| PPIO | 国内 | — |
| ModelScope | 国内 | 魔搭社区 |
| InfiniAI | 国内 | — |
| Ctyun | 国内 | 天翼云 |
| StepFun | 国内 | 阶跃星辰 |
3. 添加一个平台（自带 Key）
Section titled “3. 添加一个平台（自带 Key）”- 打开 设置 → 模型，点右上角「添加模型」，选「手动添加」（也可以选「通过对话添加」让管家引导你完成）
- 在表单里选「模型平台」，多数平台的 API 请求地址会自动带出；地址填错时软件会提示 base_url 自动修复为：…
- 填「API Key」：多个 Key 请每行一个，系统将自动轮询使用
- 从模型列表选择要启用的模型（点输入框里的放大镜可拉取模型列表），按需设置下面的选项
- 保存后，该平台会收起为一行卡片，展开能看到其中的模型
平台字段说明：
| 字段 | 说明 |
|---|---|
| 模型平台 | 决定预置地址、协议和图标；切换平台会清空已选模型，并把 API 请求地址重置为该平台的预置地址 |
| API 请求地址 | 预置平台自动带出；打开「完整 URL」开关则直接使用该地址，不拼接路径 |
| API Key | 支持多个 API Key，每行一个，系统将自动轮询使用；编辑平台时可补充 |
| 请求协议 | 仅 New API 平台显示，可选 OpenAI / Gemini / Anthropic；选择该模型的 API 请求格式，new-api 网关将使用所选协议路由到上游服务 |
| 视觉输入 | 可选「自动识别」「当前配置已启用」「当前配置已禁用」；自动识别会沿用模型目录的能力判断，仅在需要覆盖时手动启用或禁用 |
填写过程中，软件会自动检测协议和 Key（提示「正在检测 API 协议…」）。填了多把 Key 时会给出汇总结果：所有 Key 均有效、部分有效（多少个有效、多少个无效）或全部无效，按提示修正即可。
4. 日常管理
Section titled “4. 日常管理”每个平台收起为一行，悬停可见「模型（N）| API Key（N）」，展开是逐个模型的列表。
| 操作 | 在哪做 | 结果 |
|---|---|---|
| 编辑平台 | 平台行上的铅笔按钮 | 改名称、地址、Key（支持多 Key 轮询）等 |
| 加模型 / 删平台 | 平台行上的「+」「−」按钮 | 删平台前会确认「是否删除所有模型？」 |
| 启用 / 禁用 | 平台行和每个模型行的开关 | 关掉某几个模型，只留常用的 |
| 配置模型 | 模型行上的齿轮按钮 | 单独调整该模型的视觉输入等设置 |
| 健康检测 | 模型行上的心跳按钮 | 弹出「平台名 - 模型名: 成功 (延迟ms)」或失败原因；模型名前的小圆点随之变绿 / 变红，悬停可看延迟与检测时间 |
| 清除状态 | 页面右上角「清除状态」 | 清空所有健康检测结果，提示「健康状态已清除」 |
删除单个模型前会确认「是否删除该模型？」；删除只影响之后的会话。
5. 一键导入供应商配置（aionui:// 链接）
Section titled “5. 一键导入供应商配置（aionui:// 链接）”用 New API、one-api 这类网关的用户，可以直接点网页里给出的 aionui:// 链接：
aionui://add-provider?base_url=xxx&api_key=xxx——带地址和 Key 打开aionui://provider/add?v=1&data=…——把整份配置打包成一串参数打开
点击后 AIPC UP 会自动弹出「添加模型」窗口并带好已填项，你确认无误后保存即可。若浏览器提示是否允许打开外部程序，选择允许。
6. 慧AI 与 Google 登录说明
Section titled “6. 慧AI 与 Google 登录说明”Google 账号 OAuth 登录：当前版本未开放应用内的 Google 登录入口，模型一律通过 API Key 配置。如需以 Google 账号使用 Gemini，可安装 Gemini CLI Agent，并在终端完成它自己的账号登录，详见 Agents。
- 「设置 → 模型」里能看到你的平台卡片，展开能看到已启用的模型
- 填过多把 Key 时，检测提示过「所有 Key 均有效」或指出了无效 Key
- 点一次健康检测，模型名前的小圆点变绿，并显示延迟毫秒数
- 新建 Aion CLI 会话时，模型列表里能选到你刚启用的模型