Project AIRI 提供者配置指南从聊天、语音到视觉与网络搜索的完整设置【免费下载链接】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 的官方提供者Provider配置文档为主体系统讲解如何在 AIRI 中配置聊天Chat、语音合成TTS、语音识别ASR/STT、视觉理解Vision与 Artistry 等全部服务提供者以及如何在模块Modules层选择模型与音色、如何完成验证与故障排查。读完本文你将掌握 AIRI 从零提供者到可语音对话、可看图、可联网检索的完整配置路径并理解提供者凭证与模块选择之间存储与使用分离的核心架构。配置总览提供者与模块的分工AIRI 的配置体系把服务接入与能力启用清晰地分成了两层提供者Providers位于侧边栏제공자提供者负责保存服务商的 API 凭证与端点信息分为채팅聊天、비전视觉、음성 합성语音合成、전사转写、Artistry五类模块Modules位于설정 → 모듈设置 → 模块决定 AIRI 实际使用哪个提供者、哪个模型来执行某类能力如의식/Consciousness负责文本对话、음성 합성负责发声、청각/Hearing负责听音。一个关键原则是保存提供者凭证并不会自动激活该能力。你必须在对应的模块页面中显式选中提供者与模型AIRI 才会真正开始调用它。最小必需配置让 AIRI 开始对话与 AIRI 对话至少要配置一个聊天提供者和一个聊天模型。语音输出TTS和语音输入ASR/STT都是可选能力且二者相互独立、可分别开关。最小配置步骤如下打开 AIRI 的설정 → 제공자设置 → 提供者在채팅聊天分类中选择一个提供者输入凭证并完成页面提供的验证流程打开설정 → 모듈 → 의식设置 → 模块 → 意识选中刚才配置的提供者与模型发送一条消息确认 AIRI 能正常回复。提示建议先把聊天配置好再添加 TTS 与 ASR。这样一旦语音出现问题可以将其与聊天配置隔离排查避免多因素叠加导致难以定位。聊天跑通之后可按需按以下顺序扩展能力通用设置说明理解配置流程、各字段含义、验证结果与常见 FAQ聊天模型设置配置 LLM 并在意识模块中选择模型语音输入输出设置配置 TTS 与 ASR/STT并在모듈 → 음성 합성与모듈 → 청각中激活视觉理解设置配置独立的视觉提供者并选择支持图像输入的模型网络搜索设置通过 Tavily 让 AIRI 在需要时检索最新信息。通用配置流程与公共字段所有提供者的配置都遵循同一套流程详见 common.md打开설정 → 제공자在채팅 / 비전 / 음성 합성 / 전사 / Artistry中选择一类选择具体提供者在其设置页中输入要求的凭证如有必要展开高级设置按提供者官方文档填写 Base URL 等参数等待自动验证完成若提供者支持Ping API可发起一次真实请求测试可能消耗少量额度到설정 → 모듈下对应的页面选择提供者与模型/音色。公共字段一览字段含义填写说明API Key提供者签发的访问令牌完整粘贴整个密钥不要添加引号或空格Base URL提供者 API 的根地址仅当提供者文档要求不同地址时才修改需包含https://或http://完整前缀모델模型聊天、语音、识别使用的模型 ID优先使用 AIRI 列表中的模型若列表无法加载且字段允许直接输入则填写提供者文档中的准确 ID음성音色语音合成使用的音色 ID先选模型再选择该模型支持的音色리전区域部分云服务使用的部署区域与提供者控制台中显示的项目/资源区域保持一致警告凭证安全。凭证与提供者配置仅保存在当前设备的本地设置中。切勿把 API Key、AccessKey Secret 等敏感信息暴露在截图、日志、Issue 或聊天消息里。验证结果与排查顺序聊天提供者表单会自动校验必填字段字段在编辑时即自动保存。不同提供者的验证方式不同有的只校验字段格式有的会拉取模型列表有的则提供Ping API发起小额真实请求。语音提供者的 Playground 会在可能时测试合成与播放转写ASR则需要在설정 → 모듈 → 청각中选好麦克风后实测。验证失败时按以下顺序排查确认账号能访问该服务且仍有可用额度或配额重新复制 API Key确认首尾没有空格或换行恢复默认 Base URL或与提供者官方文档逐字符比对检查网络、代理、防火墙是否放行到提供者的访问选择提供者明确支持的模型——不要把显示名称当作模型 ID 使用。聊天模型LLM设置详解聊天模型是 AIRI 的大脑。要让文本回复工作需要具备可用的提供者账号或运行中的本地模型服务详见 llm.md。前置条件AIRI 已安装并运行云提供者已创建 API Key且账号可访问所选聊天模型本地提供者模型服务已运行且 AIRI 所在设备能够访问该服务。配置步骤打开설정 → 제공자 → 채팅选择提供者。不确定选哪家时可以从 OpenRouter、DeepSeek、OpenAI Compatible 或本地 Ollama 入手输入 API Key。仅当提供者文档要求不同地址时才在高级设置中修改 Base URL查看页面上的自动验证结果。提供者字段修改后立即保存验证方式因提供者而异仅校验字段 / 拉取模型列表 / 提供 Ping API打开설정 → 모듈 → 의식选择刚配置的提供者与模型。若提供者支持AIRI 会自动加载模型列表若列表不可用且字段允许手输则填写提供者官方文档中的准确模型 ID回到聊天界面发送一条短消息如 Hello收到回复即代表提供者与模型工作正常。聊天配置故障排查验证通过但找不到可用模型先确认提供者是否支持模型列表查询。部分提供者不返回模型列表或 API Key 权限不足。此时在설정 → 모듈 → 의식中直接输入模型 ID且必须与提供者文档完全一致。验证失败或请求超时检查 API Key、Base URL、账号配额与网络连接本地服务则确认服务已启动且 AIRI 能访问配置的地址。AIRI 不回复确认설정 → 모듈 → 의식中提供者与模型都已选中。记住保存凭证不会自动激活提供者。典型提供者实操OpenAI / OpenAI Compatible 与 OllamaOpenAI 与兼容 API在 openai.md 中官方端点选OpenAI第三方兼容端点选OpenAI Compatible。适用前提是你已持有 OpenAI API Key或服务商明确提供 OpenAI 兼容的聊天接口——仅仅地址以/v1结尾或 Key 以sk-开头并不保证服务真的兼容。配置要点打开설정 → 제공자 → 채팅 → OpenAI或OpenAI Compatible在基础设置中粘贴 API KeyOpenAI 官方服务保持默认 Base URLhttps://api.openai.com/v1兼容服务则填写提供者文档给出的 API 根地址不要在末尾追加/chat/completions路径验证通过后用모델 선택 →选择模型 →按钮跳转到설정 → 모듈 → 의식选择模型。失败时依次核对API Key、可用额度/配额、速率限制、网络连接兼容服务还要确认其支持 OpenAI Chat Completions API且 Base URL 是提供者文档中的 API 根地址。Ollama 本地模型ollama.md 介绍了本地运行的开源方案Ollama 提供本地 API默认无需 API Key。适合想本地原生运行模型、降低云 API 依赖、或更重视对话数据本地处理的场景。# 验证安装 ollama --version # 下载并启动模型可替换为其他模型 ID ollama run qwen2在 AIRI 中配置打开설정 → 제공자 → 채팅 → Ollama默认 Base URL 为http://localhost:11434/v1/若 Ollama 在其他设备运行则填入 AIRI 所在设备可访问的地址。然后在설정 → 모듈 → 의식中选中 Ollama 与已下载模型。警告CORS若 Ollama 已在运行但 AIRI 报 CORS 错误请把 AIRI 的精确 origin 加入OLLAMA_ORIGINS环境变量并重启 Ollama。不要为了省事使用通配符也不要把 Ollama 暴露到公网。语音输入与输出TTS / ASR设置语音能力分为两部分详见 audio.mdTTS음성 합성把文本回复朗读出来ASR/STT전사把麦克风音频转成文本。两者完全独立可分别配置。语音合成TTS配置打开설정 → 제공자 → 음성 합성选择提供者并输入凭证若提供者有 Playground先合成一句短测试句打开설정 → 모듈 → 음성 합성选择提供者、模型与音色。各提供者的详细指南位于侧边栏서비스 제공자 → 음성 합성若所用服务实现了 OpenAI 语音接口可参考 OpenAI Compatible API (TTS)。语音识别ASR/STT配置打开설정 → 제공자 → 전사选择提供者并输入凭证打开설정 → 모듈 → 청각选择提供者与模型选择正确的麦克风点击Start Monitoring说一句短句检查识别结果区域是否正确显示文本。各提供者指南位于서비스 제공자 → 전사若服务支持 OpenAI 兼容转写接口可参考 OpenAI Compatible API (ASR/STT)。语音 FAQTTS 无声确认语音合成提供者/模型/音色均已选择检查系统输出设备与音量Playground 报错则检查 API Key、账号额度与模型能力。ASR 不产出文本确认 AIRI 有麦克风权限、청각 页面选中了正确的输入设备实时识别服务还可能因网络故障或浏览器/系统收回麦克风权限而返回空结果。语言或音色不对为目标语言选择提供者支持的模型与音色转写的语言、区域、模型设置需与提供者账号中已激活的功能一致。视觉理解Vision设置视觉模块会把捕获的图像发送给支持图像输入的模型详见 vision.md。视觉提供者与聊天提供者使用相同类型的字段但AIRI 会分开存储两套配置——即使聊天提供者已保存凭证视觉提供者页面也不会自动填充需要重新输入。提示同一个服务往往同时提供聊天模型与图像理解模型所以表单字段看起来完全一样。但保存值彼此独立且必须选择明确支持图像输入的模型。选择视觉提供者与模型打开설정 → 제공자 → 비전选择提供者在此页面输入凭证。API Key、Base URL、Azure 资源信息、AWS Region 等字段与聊天版本相同但保存的值相互独立聊天与视觉两侧可以使用同一账号凭证打开설정 → 모듈 → 비전选择刚配置的提供者与支持图像输入的模型设置Capture interval控制视觉 ticker 捕获帧的频率。关于 Vision Capture仅配置视觉服务提供者与模型时不需要额外操作。但如果要让 AIRI 分析屏幕或窗口必须在시스템 → 개발자 → Vision Capture中开启必要时授予屏幕录制权限选择窗口或显示器点击Start ticker若要把分析结果发送给当前角色还需打开Publish to character。注意 Vision Capture 目前是桌面调试/开发工作流离开页面后捕获循环会停止。警告图像与凭证安全。视觉分析会把捕获的帧发送给所选提供者。不要捕获 API Key、密码、个人信息或未授权共享的内容云凭证绝不提交到仓库、截图或公开分享。本地视觉模型Ollama 与 LM Studio 都可以作为本地视觉提供者运行一个支持图像输入的模型确保 AIRI 能访问该服务在视觉提供者页面填入相应 Base URL或保持默认再到설정 → 모듈 → 비전选择模型。视觉故障排查问题解决方法提供者验证不通过即使聊天提供者已配置也要补全视觉所需的所有字段API Key、Azure Resource Name、AWS Region 等模型不分析图像确认模型明确支持图像输入选择兼容的视觉模型无法访问本地模型检查本地服务是否运行、Base URL/端口/CORS/LAN 访问设置是否正确请求被拒或额度耗尽检查账号权限、API Key、模型在区域内的可用性、配额与网络访问网络搜索Web Search设置网络搜索让 AIRI 能查询最新或陌生信息详见 web-search.md。该功能使用用户自己的 Tavily API Key。当工具被启用、且所选聊天模型支持工具调用function calling时AIRI 会在对话中发起搜索并引用返回的出处。前置条件AIRI 已安装并运行拥有 Tavily 账号及在控制台签发的 API Key所选聊天提供者与模型支持工具调用。设置步骤打开설정 → 모듈 → Web Search打开Enable Web Search开关在Tavily API Key中粘贴密钥出现Web search is ready to use!提示即可返回聊天。设置会自动保存没有单独的保存按钮。关闭开关或清空 API Key 后AIRI 将不再向 Tavily 发送搜索请求。AIRI 何时会搜索当用户明确要求搜索或问题涉及新闻、价格、最新发布、实时数据、已更新文档等时效性信息时AIRI 会检索。想要更聚焦的结果可以明确表达目标与范围例如搜索 AIRI 最新稳定版的发布说明并附上链接。在 Tavily 官方文档中查找关于 API Key 的说明。只搜索最近一周的相关更新。搜索结果会包含出处链接若结果不充分AIRI 应继续搜索或明确表示不确定。警告隐私与可信度。每次搜索都会把查询文本发送给 Tavily不要在查询中包含 API Key、密码、访问令牌、私人地址等敏感信息。搜索结果可能不准确、过时或存在偏见——医疗、法律、金融等关键信息请直接核对链接来源并以官方指南或有资质的专业人士意见为准。搜索 FAQTavily 显示已配置但 AIRI 不搜索确认Enable Web Search已开启、所选模型支持工具调用然后尝试明确要求搜索并附上出处链接。仍无效则核对提供者的工具调用支持情况。API Key / 权限 / 配额报错回 Tavily 控制台确认 Key 有效、账号额度与访问权限正常复制时避免首尾空格与换行更换 Key 后在 AIRI 中粘贴新值。结果不准确或不够新明确指定时间范围、地区或偏好来源如只看最近一周只用官方文档关键信息务必打开引用的链接亲自核实。附加设置切换显示模型与主题提供者配置完成之后你还可以更换 AIRI 的主题或切换显示的 2D/3D 模型。当前模型选择器支持 Live2D、Spine、VRM、MMD、Tachie。模型设置位于설정 → 모델。有两类实用提示导入 VTube Studio 模型把完整的 Live2D 模型文件夹打包成 ZIP 即可。AIRI 在导入过程中会忽略 VTube Studio 的items_pinned_to_model.json元数据无需手动删除。模型不加载舞台Stage会检测模型设置变更并自动重载所选渲染器。若导入的模型本身无法加载请先检查模型的包结构与资源再考虑重启 AIRI。最后建议以提供者官方文档为准配置服务提供者时尽量使用提供者文档中给出的默认地址与模型名称。Base URL、模型 ID、区域参数因提供者而异不要凭猜测填写。各提供者的专属指南覆盖聊天、语音、转写、视觉与 Artistry 的数十家服务商均可在 config 目录 下的providers/子目录中找到配置前建议先阅读对应页面。完整的配置链路可以概括为在提供者页存凭证 → 在模块页选模型 → 在对话中验证。按此顺序操作即可让 AIRI 逐步获得对话、语音、视觉与联网检索能力。【免费下载链接】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），仅供参考