AIRI 聊天模型配置指南Provider 接入、模型选择与验证排错【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi本篇指南围绕 Project AIRI 的聊天模型LLM配置展开。聊天模型是 AIRI 的大脑负责生成文本回复因此接入一个可用的聊天 Provider 是让 AIRI 开口说话的第一步。读完本文你将掌握在 AIRI 的设置 → 提供者 → 聊天页面中完成云服务与本地模型的接入、在设置 → 模块 → 意识中选择模型、理解自动验证与 Ping API 机制并能够独立排查验证通过但无模型请求超时AIRI 不回应等常见故障。前置准备在开始配置前请确认以下条件已满足AIRI 已安装并正常运行若使用云端提供者如 OpenRouter、DeepSeek、OpenAI已生成 API Key并确认账户已启用所选聊天模型若使用本地提供者如 Ollama模型服务已启动且 AIRI 运行所在的设备能够访问该服务。从整个配置流程看聊天是必须项而语音输入ASR/STT与语音输出TTS是可选且彼此独立的。建议先只配置聊天再追加语音能力以便在出问题时更容易定位是模型链路还是语音链路的故障。提供者与模型配置五个步骤完整流程围绕两个页面展开设置 → 提供者负责保存凭据设置 → 模块负责选择 AIRI 实际使用的提供者与模型。二者职责分离这是理解后续所有操作的关键。打开设置 → 提供者 → 聊天选择一个提供者。不确定选哪个时文档建议从 OpenRouter、DeepSeek、OpenAI Compatible 或本地 Ollama 开始其余聊天提供者均列在提供者 → 聊天目录下。输入 API Key。仅当提供者文档要求不同地址时才在高级设置中修改 Base URL。关注提供者页面上的自动验证结果。提供者字段在修改时会立即保存验证方式因提供者而异可能只校验字段、拉取模型列表或提供发起小规模真实请求的Ping API。打开设置 → 模块 → 意识选择刚才配置的提供者与模型。回到聊天界面发送一句 Hello 之类的短消息。收到回复即代表提供者与模型工作正常。在第 4 步中若提供者支持AIRI 会自动拉取模型列表若列表无法加载且字段支持直接输入则需按提供者官方文档填写精确的模型 ID显示名称不等于模型 ID。常见提供者的接入要点OpenRouter一个 Key 访问多家模型OpenRouter 是聚合多家模型厂商的 API 服务。当你想用一个 API Key 与一个计费账户切换多家上游模型、而不想逐个配置上游提供者时它最方便但模型可用性会受地区、网络、支付方式和上游策略影响。在 OpenRouter 控制台的 API Keys 页面新建 Key设置名称、有效期与配额限制后妥善保存在设置 → 提供者 → 聊天 → OpenRouter中粘贴 Key保留默认 Base URLhttps://openrouter.ai/api/v1/验证通过后点击模型选择 →跳转至设置 → 模块 → 意识选择可用模型。配置入口与验证方式详见 OpenRouter 提供者文档。DeepSeekOpenAI 兼容的国内模型服务DeepSeek 提供 OpenAI 格式兼容的聊天 API适合已有 DeepSeek API Key 或希望使用 DeepSeek 模型的场景。在 DeepSeek 管理控制台的 API Keys 页面新建 Key在设置 → 提供者 → 聊天 → DeepSeek中粘贴 Key保留默认 Base URLhttps://api.deepseek.com/验证通过后在设置 → 模块 → 意识中选择提供者与模型。详见 DeepSeek 提供者文档。OpenAI 与 OpenAI Compatible官方端点与第三方兼容服务使用 OpenAI 官方端点选OpenAI使用第三方兼容端点选OpenAI Compatible。注意仅凭 API 地址以/v1结尾或 Key 以sk-开头并不能保证服务兼容。官方服务在 OpenAI API Keys 页面创建 Key兼容服务则在对应提供者的控制台创建官方服务保留默认 Base URLhttps://api.openai.com/v1兼容服务则填入提供者文档给出的API 根地址不要在末尾追加/chat/completions路径若验证失败需确认该服务确实支持 OpenAI Chat Completions API且 Base URL 是文档给出的根地址。详见 OpenAI 与兼容 API 提供者文档。Ollama完全本地运行的模型Ollama 是本地运行语言模型的开源运行时提供本地 API默认无需 API Key适合追求数据本地处理、降低云端依赖的场景。从官方网站下载安装后用ollama --version确认安装成功用ollama run qwen2下载并启动模型可替换qwen2为任意模型 ID首次下载耗时取决于模型大小与网速在设置 → 提供者 → 聊天 → Ollama中保留默认 Base URLhttp://localhost:11434/v1/若 Ollama 运行在其他设备则填入 AIRI 设备可访问的 URL然后在设置 → 模块 → 意识中选择 Ollama 与已下载的模型。Ollama 专属排错Ollama 已运行但 AIRI 报 CORS 错误时应在OLLAMA_ORIGINS环境变量中加入 AIRI 的精确 origin 后重启 Ollama不要图省事使用通配符也不要将 Ollama 暴露到公网。AIRI 连接失败时先确认 Ollama 在运行、Base URL 端口正确跨设备场景应使用 AIRI 可访问的局域网地址且仅在可信网络暴露服务。详见 Ollama 提供者文档。验证机制自动校验、模型列表与 Ping APIAIRI 的提供者表单会在编辑过程中自动校验必填字段这是源码中明确实现的机制。在提供者编辑页 index.vue 中可以看到表单变化通过watch监听校验逻辑被useDebounceFn(runValidation, 1500)包裹即停止编辑 1.5 秒后自动触发校验避免每次按键都发起网络请求校验通过validateProvider执行每个校验步骤validator step都有running/success/error三种状态任一步骤失败即把提供者状态置为invalid全部通过则置为configured校验步骤因提供者而异有的只校验字段有的拉取模型列表提供Ping API的提供者会发起一次小规模真实请求可能消耗少量额度。以 Ollama 为例源码中明确存在openai-compatible:check-connectivity这一校验步骤当它失败时页面会展示针对性的连接排错提示index.vue与文档中Ollama 运行中却报 CORS的说明一一对应。这印证了验证方式因提供者不同而不同的文档描述。验证失败的通用排查顺序与 通用设置指南 一致确认账户可访问服务且有可用额度或配额重新复制 API Key排除首尾空格或换行恢复默认 Base URL或与提供者官方文档逐字符核对确认网络、代理、防火墙允许访问该提供者选择提供者明确支持的模型不要用显示名称冒充模型 ID。故障排查验证通过但没有可用模型先确认提供者是否支持模型列表查询——部分提供者不返回模型列表或 API Key 缺少相应权限。此时在设置 → 模块 → 意识中直接输入模型 ID且必须与提供者文档完全一致。验证失败或请求超时按顺序检查API Key、Base URL、账户额度、网络连接。若是本地服务确认服务正在运行且 AIRI 能访问配置的地址参考上文 Ollama 的局域网与 CORS 注意事项。AIRI 不回应在设置 → 模块 → 意识中确认提供者与模型都已选中。需要注意保存提供者凭据并不会自动激活该提供者——提供者的配置完成状态与模块中被选中是两回事这正是提供者页保存凭据、模块页选择使用职责分离设计的直接后果。下一步聊天链路打通后即可配置语音能力前往 语音输入与输出设置让 AIRI 能开口说话TTS并接收麦克风输入ASR/STT也可按需继续阅读 视觉理解设置 与 网页搜索设置。AIRI 的全部提供者目录覆盖聊天、视觉、语音合成、转写与 Artistry 五大类别聊天只是起点。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考