API Key 管理
统一管理模型 API Key。社区版需自行配置；专业版由平台托管下发，通常无需手动维护。
一、功能定位
API Key 管理 是 OmniAgent 的设置核心之一。通过此页面，您可以集中维护各个大模型厂商（如 DeepSeek、阿里云 Qwen、Anthropic 等）的认证凭据。
统一管理后，Agent 在执行任务时会自动根据当前选用的模型读取对应的 Key 配置，无需在每次对话时重复输入。
二、界面总览
在「设置中心」-「大模型Key」页签下，系统以可视化卡片的形式汇总了所有已配置的密钥项。
- 搜索与筛选：顶部的搜索框支持按提供商、模型名称或密钥片段快速定位。
- 状态快览：每张卡片上直观显示「已生效」或「未生效」状态标签，并提供开关切换。
- 生效开关：点击卡片上的开关可以切换密钥的生效状态。只有标记为「已生效」的密钥，才会出现在首页的模型选择器中供使用。
未生效的密钥无法使用
如果某个密钥处于「未生效」状态，它将不会出现在首页的模型选择列表中。请确保您需要使用的密钥已切换为「已生效」。
配置并生效的密钥，会自动出现在首页底部的 模型选择器 中：
- 点击首页底部的模型名称区域，弹出「模型库」下拉面板。
- 面板中仅列出状态为 「已生效」 的密钥对应的模型。
- 选择目标模型后，后续对话和任务将使用该模型执行。
- 如果模型库中没有可选模型，请检查是否有密钥已添加并切换为「已生效」状态。
三、详情管理与编辑
点击卡片右侧的展开箭头，即可进入该密钥的详细配置视图。
配置项与动作
- 提供商：标识该 Key 所属的厂商（如 Qwen、Anthropic 等），通过下拉菜单选择。
- 模型名称：对应厂商的具体模型系列（如
qwen3.5-plus或claude-opus-4-6）。 - API Key (密钥)：核心认证信息。支持点击「眼睛」图标查看明文，或点击「复制」图标。
- Base URL (地址)：API 调用的基础路径。若您使用中转服务或特定私有化节点，请在此处修改。
- 当前状态：显示密钥当前是「已生效」还是「未生效」。
- 系统动作：
- 保存 (磁盘图标)：保存当前卡片内的修改。
- 删除 (垃圾桶图标)：彻底移除此配置项。
四、新增 API 密钥
若需添加新的模型支持，您只需操作以下步骤：
- 触发添加：点击列表末尾带有 「+ 添加密钥」 字样的空白卡片。
- 填写表单：在弹出的新增面板中，依次选择提供商、输入模型名称、粘贴 API Key 并确认 Base URL。
- 完成保存：点击下方的「保存」图标，系统将自动保存该 Key。
- 切换生效：保存后需将该密钥的开关切换为「已生效」，方可在首页模型选择器中使用。
五、状态排查与安全建议
| 状态显示 | 含义及对策 |
|---|---|
| 已生效 (绿色) | 配置就位，可在首页模型选择器中选用。 |
| 未生效 (灰色) | 密钥已保存但未激活。点击卡片上的开关切换为「已生效」即可使用。 |
安全提醒
OmniAgent 采用本地加密存储技术保护您的 Key。请勿在截图分享或远程协助时展示明文 Key，以免产生额度损失或安全风险。
建议您下一步
查看 模型服务 了解更多模型配置细节。