跳到主要内容

AI 服务商配置

AIME Chat 通过 Provider 连接聊天、Embedding、重排、搜索、OCR、语音和图像等模型服务。内置 Provider 与模型目录会随版本更新,因此本页不维护容易过期的固定模型清单;以应用中的 设置 → AI 服务商 和模型选择器为准。

添加 Provider

首次设置或后续配置的基本流程相同:

  1. 打开 设置 → AI 服务商,点击添加。
  2. 选择 Provider 类型并填写自定义名称。
  3. 填写 API Key;需要代理、兼容网关或私有部署时填写 API Base。
  4. 保存后读取模型列表。
  5. 只启用实际需要的模型,并保存模型配置。
  6. 回到聊天或 Agent 详情页选择模型。

应用会从内置动态目录生成聊天 Provider 列表,并额外提供 OpenAI Responses API、Ollama,以及 Brave Search、SerpAPI、Tavily、Jina.ai、MinerU、ElevenLabs、PaddleOCR API 等专项 Provider。不同类型需要的字段和模型能力不同。

管理模型

Provider 保存后,可以在模型列表中:

  • 启用或停用模型;
  • 搜索模型 ID 或名称;
  • 手动添加目录中没有的模型;
  • 编辑模型 ID、名称、输入模态、上下文长度和工具调用支持。

手动填写的能力声明必须与服务端真实能力一致。例如,把不支持图片或工具调用的模型标记为支持,并不会让服务端获得该能力,反而可能导致请求失败。

控制模型数量

只启用常用模型可以让聊天和 Agent 的模型选择器更清晰。模型目录更新频繁,不建议把某个型号长期写死在 Agent Instructions 中。

API Base 与兼容接口

API Base 适用于官方地址以外的兼容端点、企业网关或本地代理。配置时注意:

  • 按 Provider 文档确认地址是否需要包含 /v1 等路径;
  • 不要把聊天接口、Responses 接口和 OpenAI-compatible 接口混为一谈;
  • 网关使用自签名证书、代理或额外 Headers 时,先在同一台机器上验证连通性;
  • 模型 ID 必须使用目标服务真实接受的值。

本地模型

Ollama

  1. 安装并启动 Ollama。
  2. 在终端确认 ollama list 能看到已下载模型。
  3. 在 AIME Chat 添加 Ollama Provider;远程运行时填写相应 API Base。
  4. 获取模型列表,启用需要的模型。

默认本地地址通常是 http://127.0.0.1:11434,但应以你的 Ollama 配置为准。

LM Studio 与其他兼容服务

先在服务端启用本地 API,再使用相应 Provider 类型或兼容端点配置 API Base。应用与模型服务运行在不同机器、容器或虚拟机时,127.0.0.1 指向各自环境,需改成客户端可访问的地址。

为不同能力选择 Provider

模型名称不能替代能力验证。配置前先确认目标用途:

用途需要确认的能力
普通聊天文本输入输出、上下文长度
Agent 工具模型和 Provider 都支持 tool calling
图片理解输入模态包含图片,并使用兼容消息格式
知识库向量Embedding 模型与稳定的向量维度
知识库重排Reranker 接口与模型类型
图像、语音、OCR对应专项 Provider 与运行库已配置
Web Search搜索 Provider 的 Key、区域和配额可用

更换知识库 Embedding 模型会触发全量向量重算;详见 知识库管理

密钥与本地数据

Provider 配置保存在本地应用数据库中,供主进程发起请求时使用。当前文档不把这种存储描述为静态加密保险箱,因此仍应:

  • 保护操作系统账户、应用数据目录和备份;
  • 使用权限最小、可轮换的 API Key;
  • 不在截图、聊天、日志、仓库或 Agent 导出配置中粘贴真实密钥;
  • 停用或删除不再使用的 Provider,并在服务商控制台撤销旧密钥。

常见问题

无法获取模型列表

  1. 检查 API Key、API Base、网络和代理。
  2. 确认账户权限、余额或配额。
  3. 某些兼容服务不提供模型列表接口,可手动添加服务端支持的模型 ID。

模型在聊天中不可见

确认 Provider 和模型都已启用,并检查当前入口是否只筛选聊天模型。Embedding、重排、搜索或 OCR Provider 不一定会出现在普通聊天模型选择器中。

工具调用或多模态请求失败

核对模型编辑器中的工具调用与输入模态声明,并以服务商当前文档为准。模型 ID 相似并不表示不同端点具有相同能力。

本地服务连接失败

确认服务进程正在监听、端口没有被防火墙阻断,并从运行 AIME Chat 的系统测试 API Base。容器或远程主机上的 localhost 通常不是桌面应用所在机器。