配置模型 API
安装 Agent 后，它还需要连接一个模型服务才能工作。你可以把 API Key 理解为该服务为你生成的一把专用钥匙。
还没有 Key 时，先进入 API 配置中心，按服务商完成官方注册、计费开通和 Key 创建。
- 模型服务商提供的 API Key；
- 服务商说明中的 Base URL；
- 你有权使用的准确模型 ID。
在 EasyAI 中添加
Section titled “在 EasyAI 中添加”- 打开 AI Agents，找到已安装的 Agent。
- 点击卡片上的 配置 API 图标。
- 选择 添加服务商。
- 填写服务商名称、API 类型、Base URL、API Key 和默认模型。
- 打开 启用此服务商，保存配置。
- 在列表中对该服务商执行 重新检测。
- 确认无误后选择右上角的 配置生效。
看到“可访问”后即可新建会话。如果测试失败，先检查 API Key 是否完整、账号是否有可用额度，以及模型名称是否正确。
每个字段是什么意思
Section titled “每个字段是什么意思”这是你自己看到的名称，不影响官方账号。建议使用“OpenAI 官方”“DeepSeek”之类一眼能认出的名字。
API 类型
Section titled “API 类型”API 类型决定 EasyAI 用什么方式向服务商发送请求。按对应服务商教程选择：
| API 类型 | 常见用途 |
|---|---|
| OpenAI Responses | OpenAI 新配置、xAI、支持 Responses 的兼容服务 |
| OpenAI Chat Completions | 只支持传统 Chat Completions 的服务或兼容工具 |
| Anthropic Messages | Anthropic Claude，以及明确提供 Anthropic 兼容接口的服务 |
| Gemini GenerateContent | Google Gemini Developer API |
协议选错时，即使 Key 和余额都正常，也可能看到 400、404 或 422 错误。
Base URL
Section titled “Base URL”Base URL 是 API 的基础地址，不是服务商官网，也不是带完整请求路径的地址。例如 OpenAI 官方是 https://api.openai.com/v1。
只使用服务商官方文档给出的地址。不要把 /responses 或 /chat/completions 再加到教程给出的 Base URL 后面，除非服务商明确要求。
API Key
Section titled “API Key”粘贴开发者平台创建的完整 Key。EasyAI 输入框会隐藏显示，但你仍不应在截图、聊天或公开文档中暴露它。
填写服务商 API 文档中的准确模型 ID。会员方案名、产品展示名和 API 模型 ID 不是一回事；还要确认当前账号、Project 或 Team 有使用权限。
连接检测怎么看
Section titled “连接检测怎么看”| 状态 | 含义与下一步 |
|---|---|
| 可访问 | 当前 Key、地址和网络路径可以正常访问服务 |
| 认证失败 | Key 错误、过期、撤销，或没有所需权限 |
| 网络不可达 | 当前网络无法连接 Base URL，先核对地址与网络 |
| 超时 | 服务未在限定时间内响应，稍后重试 |
| 服务端错误 | 已经连接到服务商，但服务暂时异常 |
| 未配置 | 必填字段不完整，回到编辑窗口检查 |
检测结果只能证明当时的连接状态。服务商余额、模型权限或网络变化后，状态也会变化。
配置多个服务
Section titled “配置多个服务”EasyAI 支持为一个 Agent 保存多个模型服务。你可以：
- 拖动调整优先顺序；
- 临时停用某一项而不删除；
- 复制现有配置后只替换模型或 Key；
- 分别检测每个服务；
- 删除不再使用的服务商。
日常使用时，把最常用且检测可用的服务放在前面。修改完成后记得选择 配置生效；新设置通常从新会话开始最稳定。