AIRI 接入 n1n 聊天模型从服务准备到配置验证的完整指南【免费下载链接】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/airin1n 是 AIRI 中内置的 API 兼容聊天模型服务商通过填写服务地址与账户凭据即可接入其模型服务无需自建推理环境。本文基于仓库内 n1n 配置文档与 提供商注册实现完整讲解服务访问准备、AIRI 内配置步骤、自动校验原理与常见排障帮助你快速把 n1n 作为意识Consciousness模块的对话模型接入 AIRI。为什么选择 n1nn1n 以 OpenAI 兼容的 API 形式对外提供聊天模型服务。在 AIRI 中使用 n1n只需要在设置界面中填写两项信息服务地址Base URL与账户凭据API KeyAIRI 即可像调用标准 OpenAI 接口一样发起对话请求。从仓库源码看n1n 提供商的实现方式非常轻量在 n1n 提供商标识文件 中它通过createOpenAI(config.apiKey || , config.baseUrl)直接构造一个 OpenAI 兼容客户端官方描述为 n1n.ai - High-performance AI API provider.。因此你现有的 n1n 服务地址、模型名称与密钥体系都能无缝映射到 AIRI 的聊天能力中。第一步准备服务访问方式在开始配置前先到 n1n 官方平台登录 n1n确认两件事服务 URL你实际使用的 API 网关地址通常形如https://api.n1n.ai/v1/是否需要 API Key取决于你的账户类型、服务套餐以及部署方的访问策略有些场景可能允许匿名访问此时 API Key 可以留空。凭据安全警告即使 API Key 是可选字段也不要公开你的私有服务地址、访问令牌或网关配置。这些信息一旦泄露他人即可冒用你的服务配额。第二步在 AIRI 中配置 n1n配置入口为设置Settings→ 服务商Providers→ 聊天Chat→ n1n。需要填写的字段只有两个字段说明默认值Base URLn1n 的 OpenAI 兼容 API 服务地址https://api.n1n.ai/v1/API Keyn1n 账户凭据若部署允许匿名访问则留空空源码视角字段定义与默认值在 n1n 提供商标识文件 中两个字段通过 Zod schema 定义apiKey可选字符串UI 上以password类型渲染密文输入框baseUrl可选字符串带默认值https://api.n1n.ai/v1注意源码默认值末尾没有斜杠界面展示时通常会补全为/。同时该提供商声明了tasks: [chat]即它只提供聊天这一种任务能力不会出现在语音合成、转写等其他模块的服务商列表中。在提供商标录中的order: 9决定了它在服务商目录里的排序位置而 提供商标录属性表 将 n1n 归类为paidCloud付费、云端部署界面筛选时会据此打上对应标签。关于 API Key 留空n1n 提供商通过validationRequiredWhen(config)决定何时触发自动校验validationRequiredWhen(config) { return !!config.apiKey?.trim() }也就是说只有当你填写了非空 API Key 时AIRI 才会自动对 n1n 发起连接校验若 API Key 留空则按未配置处理等待后续手动操作。这与文档中如果部署允许匿名访问则按部署方说明保留为空的指引完全一致。第三步验证配置AIRI 在编辑配置的过程中会自动执行校验。校验通过的标准视配置内容而定填写了 API Key执行完整的连接、模型列表与对话能力三项检查未填写 API Key保持未配置状态不触发自动校验。界面上的两个关键操作Ping API手动发起一次真实的 API 请求测试用于验证网络连通、服务地址与凭据是否正确。该按钮在配置可校验时出现选择模型 →校验通过后用此按钮跳转到设置 → 模块 → 意识Settings → Modules → Consciousness在这里选择 n1n 作为服务商并挑选具体模型然后启用。源码视角校验器的三层检查n1n 复用了 AIRI 的 OpenAI 兼容校验器体系见 openai-compatible.ts配置了三种校验项见 ProviderValidationCheck 枚举Connectivity连接性向{baseUrl}/models发起一次 GET 请求超时 10 秒带Authorization: Bearer apiKey头确认服务地址可达。仅当响应状态码 ≥ 500 时判定失败400/401 等业务错误不会被误判为网络不可达ModelList模型列表拉取/models返回的模型清单并校验其非空确保该服务地址确实能列出可用的模型ChatCompletions对话补全用探测到的模型发送一次generateText探测请求max_tokens: 16的最小输出限制验证服务端真实支持对话补全。该探测结果会在同一次配置校验流程内通过缓存 互斥锁去重避免重复请求。此外还有一个配置格式校验check-config它会校验 Base URL 必须是绝对 URL能以new URL()正常解析且包含 host并判断 API Key 是否缺失。因此如果你看到Base URL is not absolute之类的提示应检查地址是否漏写了https://协议头。排查验证失败怎么办当校验失败时按以下顺序检查服务地址Base URL 是否与 n1n 平台展示的完全一致含协议头https://与路径/v1地址末尾是否有多余或缺失的斜杠API Key是否过期、是否复制完整注意不要带入首尾空格以及账户是否有权限访问该服务端点部署方访问策略如果服务允许匿名访问请按部署方说明留空 API Key而不是随便填一个占位值——从validationRequiredWhen的实现看填入内容即会触发自动校验错误的占位凭据反而会导致校验失败网络可达性确认运行 AIRI 的设备能够直接访问该服务地址例如自建网关需要确保防火墙、代理或 CORS 策略放行必要时可先用curl手动验证。如果以上都正常但仍失败可再次点击Ping API观察报错信息并结合连通性、模型列表、对话补全三个校验项的失败提示定位是网络层、认证层还是模型层的问题。小结在 AIRI 中接入 n1n 只需三步确认服务地址与凭据策略 → 在设置 → 服务商 → 聊天 → n1n中填入 Base URL默认https://api.n1n.ai/v1/与 API Key可选→ 通过Ping API验证后在设置 → 模块 → 意识中选择 n1n 模型并启用。得益于 AIRI 统一的 OpenAI 兼容提供商框架注册、属性、校验器均可在 providers 目录 中查阅n1n 的配置体验与其他 API 兼容服务商保持一致且校验逻辑会自动覆盖连接、模型列表与真实对话三个层面让配置错误在启用前就被及早发现。【免费下载链接】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），仅供参考