OMate 中配置 API 密钥 —— 设置页面完整流程
拿到模型服务商的 API 密钥后，在 OMate 设置页面完成配置。
添加新 API 配置
- 进入设置页面，左滑 API 设置卡片，或点击进入 API 管理
- 点击 API 配置列表的加号按钮
- 填写配置信息：
必填字段
| 字段 | 说明 |
|---|---|
| 名称 | 给这个 API 配置起个名字，方便后续切换 |
| API 规范 | OpenAI（最常用）/ Claude（1.0.13+ 支持） |
| API 密钥 | 从服务商控制台复制的密钥 |
快捷填写
OMate 在 API 设置卡片右下角提供浮动按钮——点击可以快捷填入预置的服务商配置（如硅基流动、DeepSeek），省去手动填写 API 地址。
多 API 配置
- 可以添加多个 API 配置（不同服务商、不同模型、不同用途）
- 系统自动将最新添加的配置设为活跃状态
- 活跃配置会被所有需要 API 的功能默认使用
- 在单个对话、角色、故事的设置里可以覆盖，使用其他 API 配置
管理配置
| 操作 | 方式 |
|---|---|
| 编辑 | API 卡片左滑 → 自动进入编辑模式 |
| 删除 | API 卡片右滑 → 确认删除（系统要求至少保留一个） |
| 切换活跃 | 设置 → API 设置 → 选中要激活的配置 |
模型参数（chatModelParams）
API 配置的「模型参数」栏支持以查询串格式传入附加请求参数，如 max_tokens=2048&top_p=0.9。常用键：
max_tokens：单次回复的输出 token 上限（注意与「最大上行字数」不同，后者限制的是发送出去的内容量）top_p、frequency_penalty等采样参数：按所选服务商支持情况透传
安全说明
OMate 只在本地存储你的 API 密钥，不会上传到任何服务器。但仍然建议妥善保管，不要与他人分享。