本教程详细介绍如何在 AionUi 中配置各种大语言模型 —— Gemini、OpenAI、Anthropic、ModelScope、OpenRouter 等平台，以及多 API Key 轮换等高级功能。

English | 简体中文

AionUi 支持 28+ 大模型平台，包括官方平台、云服务提供商、中国平台和国际平台。所有平台通过统一入口配置：设置 → 模型 → 添加模型。

官方平台

• Gemini - API Key | ✅ 多 Key 支持 | 图像生成、工具调用
• Gemini (Vertex AI) - API Key + Project ID | ✅ 多 Key 支持 | 企业级 AI 服务
• OpenAI - API Key | ✅ 多 Key 支持 | 函数调用、图像生成
• Anthropic - API Key | ✅ 多 Key 支持 | Claude 系列模型

云服务提供商

• AWS Bedrock - Access Key / Profile | ❌ 多 Key 支持 | AWS 企业级 AI 服务
• New API - API Key | ✅ 多 Key 支持 | 统一多模型网关

中国平台

• Dashscope (Qwen) - API Key | ✅ 多 Key 支持 | 通义千问系列
• Dashscope Coding Plan - API Key | ✅ 多 Key 支持 | 通义灵码订阅版
• Zhipu - API Key | ✅ 多 Key 支持 | 智谱 AI
• Moonshot (China) - API Key | ✅ 多 Key 支持 | 月之暗面（中国）
• Moonshot (Global) - API Key | ✅ 多 Key 支持 | 月之暗面（全球）
• Qianfan - API Key | ✅ 多 Key 支持 | 百度千帆
• Hunyuan - API Key | ✅ 多 Key 支持 | 腾讯混元
• Lingyi - API Key | ✅ 多 Key 支持 | 零一万物
• ModelScope - API Key | ✅ 多 Key 支持 | 魔搭社区
• InfiniAI - API Key | ✅ 多 Key 支持 | 无问芯穹
• Ctyun - API Key | ✅ 多 Key 支持 | 天翼云
• StepFun - API Key | ✅ 多 Key 支持 | 阶跃星辰

国际平台

• DeepSeek - API Key | ✅ 多 Key 支持 | DeepSeek 模型
• MiniMax - API Key | ✅ 多 Key 支持 | MiniMax AI
• Novita - API Key | ✅ 多 Key 支持 | Novita AI 网关
• OpenRouter - API Key | ✅ 多 Key 支持 | 多模型聚合网关
• PPIO - API Key | ✅ 多 Key 支持 | PPIO 推理网关
• SiliconFlow-CN - API Key | ✅ 多 Key 支持 | SiliconFlow（中国）
• SiliconFlow - API Key | ✅ 多 Key 支持 | SiliconFlow（全球）
• xAI - API Key | ✅ 多 Key 支持 | xAI Grok 模型
• Ark - API Key | ✅ 多 Key 支持 | 火山引擎 Ark
• Poe - API Key | ✅ 多 Key 支持 | Poe 平台

自定义平台

• Custom - API Key | ✅ 多 Key 支持 | OpenAI 兼容接口（支持 Ollama、LM Studio 等本地模型）

---

1. 获取 Gemini API Key

   • 访问 Google AI Studio
   • 使用 Google 账号登录
   • 在 "API Keys" 页面创建新的 API Key

2. 在 AionUi 中配置

   • 点击左侧边栏的 "设置" 图标
   • 选择 "大模型设置"
   • 点击 "添加模型" 按钮
   • 选择平台：Gemini
   • 输入 API Key
   • 系统会自动获取可用的模型列表

New API 是一个统一的多模型网关，可以聚合访问多种 LLM 模型。

1. 获取 New API Key

   • 访问 New API GitHub 了解部署方式
   • 或使用已部署的 New API 服务
   • 获取 API Key

2. 在 AionUi 中配置

   • 选择平台：New API
   • 输入 Base URL（New API 服务地址）
   • 输入 API Key
   • 选择模型（支持多种协议：OpenAI、Gemini、Anthropic）
   • 可选：为特定模型配置协议覆盖（modelProtocols）

💡 提示：New API 支持为不同模型配置不同的协议，例如 Gemini 模型使用 gemini 协议，Claude 模型使用 anthropic 协议。

AWS Bedrock 是 AWS 的企业级 AI 服务平台，支持多种认证方式。

1. 准备 AWS 凭证

   • 方式一：Access Key
     • 在 AWS IAM 中创建用户并生成 Access Key ID 和 Secret Access Key
     • 确保用户有 Bedrock 访问权限
   • 方式二：Profile
     • 在本地配置 AWS CLI Profile（aws configure --profile <profile-name>）
     • 使用已配置的 Profile 名称

2. 在 AionUi 中配置

   • 选择平台：AWS Bedrock
   • 选择认证方式：Access Key 或 Profile
   • 如果选择 Access Key：
     • 输入 AWS Region（如 us-east-1）
     • 输入 Access Key ID
     • 输入 Secret Access Key
   • 如果选择 Profile：
     • 输入 AWS Region
     • 输入 Profile 名称（已在本地配置的 AWS CLI Profile）
   • 系统会自动获取可用的 Claude 模型列表

支持的 AWS Region：

• us-east-1 - US East (N. Virginia)
• us-west-2 - US West (Oregon)
• eu-west-1 - Europe (Ireland)
• eu-central-1 - Europe (Frankfurt)
• ap-southeast-1 - Asia Pacific (Singapore)
• ap-northeast-1 - Asia Pacific (Tokyo)
• ap-southeast-2 - Asia Pacific (Sydney)
• ca-central-1 - Canada (Central)

Vertex AI 是 Google Cloud 的企业级 AI 服务平台。

1. 获取 Vertex AI 凭证

   • 访问 Google Cloud Console 创建项目
   • 在 API 和服务 → 库 中启用 Vertex AI API
   • 记下你的 Project ID（格式如 my-project-123456）
   • 生成 Vertex AI API Key

2. 在 AionUi 中配置

   • 选择平台：Gemini (Vertex AI)
   • 输入 Google Cloud Project ID
   • 输入 API Key
   • 系统会自动获取可用的 Vertex AI 模型列表

自定义平台允许你配置任何支持 OpenAI 兼容接口的模型服务 —— 通常用于本地部署的模型，或不在预设列表中的供应商。

1. 获取 API Key

   • 访问平台的 API Key 管理页面（本地模型可跳过）
   • 创建 API Key 并复制

2. 在 AionUi 中配置

   • 选择平台：Custom
   • 输入平台的 Base URL
   • 输入 API Key（无认证的本地模型可填任意非空占位符）
   • 输入要使用的模型名称

本地模型示例：

• Ollama: http://localhost:11434/v1（本地部署）
• LM Studio: http://localhost:1234/v1（本地部署）

💡 已经在预设列表中的平台（OpenAI、Anthropic、DeepSeek、xAI、Moonshot、Zhipu、Dashscope、SiliconFlow、Ark、Qianfan、Hunyuan、Lingyi、Poe、InfiniAI、Ctyun、StepFun、Novita、PPIO、MiniMax、OpenRouter、ModelScope）可直接选择 —— Base URL 会自动填充，你只需粘贴 API Key 即可。

AionUi 提供了多个预设平台，选择后会自动填充 Base URL，您只需输入 API Key 即可。

中国平台配置示例：

1. Dashscope (Qwen)

   • 访问 Dashscope 控制台
   • 创建 API Key
   • 在 AionUi 中选择 Dashscope，输入 API Key

2. Zhipu (智谱 AI)

   • 访问 Zhipu 开放平台
   • 创建 API Key
   • 在 AionUi 中选择 Zhipu，输入 API Key

3. Moonshot (月之暗面)

   • 访问 Moonshot 控制台
   • 创建 API Key
   • 在 AionUi 中选择 Moonshot (China) 或 Moonshot (Global)，输入 API Key

4. ModelScope (魔搭)

   • 访问 ModelScope
   • 登录阿里云账号，创建访问令牌
   • 在 AionUi 中选择 ModelScope，输入 API Key

国际平台配置示例：

1. OpenRouter

   • 访问 OpenRouter
   • 注册账号并创建 API Key
   • 在 AionUi 中选择 OpenRouter，输入 API Key
   • 支持访问多种开源和商业模型

2. DeepSeek

   • 访问 DeepSeek 控制台
   • 创建 API Key
   • 在 AionUi 中选择 DeepSeek，输入 API Key

3. SiliconFlow

   • 访问 SiliconFlow 或 SiliconFlow Global
   • 创建 API Key
   • 在 AionUi 中选择 SiliconFlow-CN 或 SiliconFlow，输入 API Key

💡 提示：所有预设平台都支持多 API Key 轮换，只需在 API Key 字段中输入多个 Key（逗号或换行分隔）即可。

---

AionUi 支持多 API Key 自动轮换，提高服务可靠性和可用性：

• 自动轮换: 当某个 API Key 遇到错误时自动切换到下一个
• 智能黑名单: 失败的 Key 会被临时黑名单 90 秒
• 错误恢复: 黑名单过期后自动恢复使用
• 负载均衡: 随机选择起始 Key，分散请求压力

1. 在 API Key 字段中输入多个 Key

   sk-xxx1,sk-xxx2,sk-xxx3
   

   或使用换行分隔：

   sk-xxx1
   sk-xxx2
   sk-xxx3
   

2. 支持的平台

   • ✅ Gemini: 支持多 Key 轮换
   • ✅ Gemini (Vertex AI): 支持多 Key 轮换
   • ✅ OpenAI: 支持多 Key 轮换
   • ✅ Anthropic: 支持多 Key 轮换
   • ✅ 自定义平台: 支持多 Key 轮换（使用 OpenAI 兼容接口）
   • ✅ New API: 支持多 Key 轮换
   • ✅ 所有使用 OpenAI 兼容接口的平台: 支持多 Key 轮换
     • ModelScope、OpenRouter、Dashscope、DeepSeek、MiniMax、SiliconFlow、Zhipu、Moonshot、xAI、Ark、Qianfan、Hunyuan、Lingyi、Poe、InfiniAI、Ctyun、StepFun 等
   • ❌ AWS Bedrock: 不支持多 Key 轮换（使用 AWS 凭证认证）

1. 错误检测

   • 检测到 401（认证失败）、429（限流）、503（服务不可用）等错误
   • 自动将当前 Key 加入黑名单

2. 自动切换

   • 从可用 Key 列表中随机选择下一个
   • 更新环境变量，重新初始化客户端

3. 黑名单管理

   • 失败的 Key 被黑名单 90 秒
   • 黑名单过期后自动恢复使用
   • 避免频繁切换导致的性能问题

---

A: 检查方法：

• 在模型列表中能看到配置的平台和模型
• 在对话界面能选择到配置的模型
• 发送消息能正常收到回复

A: 检查要点：

• 确保 Key 格式正确（逗号或换行分隔）
• 检查平台是否支持多 Key（支持的平台：Gemini、Vertex AI、OpenAI、Anthropic、New API 和所有使用 OpenAI 兼容接口的平台）
• 查看控制台日志了解轮换状态
• 注意：AWS Bedrock 不支持多 Key 轮换，因为它使用 AWS 凭证认证而非 API Key

A: 可能原因：

• API Key 无效或过期
• Base URL 配置错误
• 网络连接问题
• 平台服务暂时不可用

A: 切换方法：

• 在任意会话中使用输入框左下角的模型选择器切换
• 每个 Agent（内置、Claude Code、Codex、Qwen Code 等）都有自己独立的可用模型列表
• 系统会按会话记住你的选择偏好

A: 检查配置：

• 确保模型支持 function_calling 能力
• 重新保存配置并重启应用

---

• 快速入门: 快速入门指南
• 图像生成配置: 图像生成配置指南
• 多Agent模式配置: 多Agent模式配置
• 常见问题: 常见问题

---

需要帮助？

• 🐛 报告问题
• 💬 社区讨论
• 📖 完整文档

配置完成后，你就可以享受多平台、多模型的 AI 体验了！