软件使用手册合辑

API密钥配置与模型分工

本篇讲 OMate「自带钥匙」的机制:为什么必须填自己的密钥、配置怎么加、六类模型各管什么,以及想省钱时怎么分工。相关文档:角色卡导入与酒馆生态迁移 · 安卓安装与首次上手


一、为什么必须填自己的密钥

OMate 不提供模型服务,所有 AI 回复都走用户自己填的 API 密钥。这带来三个直接后果:

支持两种接口规范:OpenAI 规范通吃,Claude 规范从 1.0.13 起可用(覆盖聊天和总结模型)。各家服务商支持程度不同,个别服务商下可能无法正常工作,选主流服务商出问题的概率最低。

二、添加配置与日常管理

  1. 进「设置 → API 设置」,点「+」新增;
  2. 填三项必填:名称(随意)、API 规范、密钥;
  3. 保存后自动成为活跃配置,全局生效。

日常操作都靠滑卡片:左滑编辑、右滑删除(要输入确认,且至少保留一个配置)。表单右下角的浮动按钮能快捷填入预设服务商配置;配置支持导出成文件、扫码导入,换机迁移省事。每个对话还能单独换用另一套配置——日常聊天用便宜模型,写长篇时切到更强的。

三、六类模型各管什么

功能不止聊天一种,不同功能吃不同的模型:

模型类型管什么能否用对话模型顶替
对话模型与角色聊天——(主力)
总结模型记忆提取、自动标题;不填则对话模型兼任可顶替(单独配个便宜的更省)
嵌入模型知识库向量化不能
语音模型语音播放与通话的合成不能
生图模型创建角色时生成头像背景不能
语音识别模型语音通话里把你说的话转文字不能

记两条就够:只聊天,配一个对话模型就行;想用知识库、语音、生图,对应位置必须另填专门模型——拿对话模型的名字填进嵌入模型位置是不工作的。

四、省钱与零成本的路径

五、配好之后怎么验证

发一条消息,有流式回复就是通了。报错先查规范选对没有、密钥是否有效、服务商兼容性,九成的「没回复」都出在 API 配置这一层。装好应用是这一切的前提,步骤见 安卓安装与首次上手;想让角色真正开口,还差一张角色卡,见 角色卡导入与酒馆生态迁移。

更多功能拆解与界面实拍,见 omate 速览站。

同站更多文档

  1. 安卓安装与首次上手
  2. 角色卡导入与酒馆生态迁移