在 AIRI 中接入 n1nOpenAI 兼容聊天模型服务的配置指南【免费下载链接】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 是一家提供高性能 AI API 服务的云提供商AIRI 以 OpenAI 兼容协议的方式将其接入聊天chat任务让你在 n1n 账号上直接使用其模型服务。本文以 n1n 的接入文档为主线结合 AIRI 仓库中provider-inference包的 n1n 服务商实现与校验器源码完整讲解从准备服务访问、填写配置、执行验证到排障的每一步读完即可在 AIRI 中完成 n1n 的配置与启用。n1n 在 AIRI 中的定位AIRI 通过服务商Providers机制统一管理各类模型推理服务。n1n 属于其中的云端服务商在 stage-ui 的属性分类 中被标记为paidCloud即付费云端服务其能力范围为tasks: [chat]也就是提供聊天补全chat completions能力。从 n1n 服务商实现 可以看到其底层通过createOpenAI来自xsai-ext/providers/create构造 OpenAI 兼容客户端这意味着 n1n 暴露的是标准的 OpenAI 风格 API。因此AIRI 中任何按 OpenAI 兼容协议编写的校验逻辑与调用链路都可以直接复用于 n1n。核心配置项一览n1n 服务商的配置结构对应源码中的n1nConfigSchema见 index.ts只有两个字段配置项是否必填默认值说明apiKey可选无n1n 服务账号的 API Key部署允许匿名访问时可留空baseUrl可选https://api.n1n.ai/v1服务地址界面中显示为默认 Base URL两个字段在表单中分别以密码框type: password和普通文本框的形式呈现对应的表单标签、占位文案均由国际化系统提供见 zh-Hans/settings.yaml其中 n1n 的描述文案为n1n.ai - 高性能的 AI API 提供商。第一步准备服务访问方式在 AIRI 中配置之前先要确认你的 n1n 服务访问信息打开并登录 n1n 的服务站点n1n.ai确认你的服务地址以及当前服务是否需要 API Key。如果你的 n1n 部署允许匿名访问即无需凭据即可调用则确认该访问策略后续在 AIRI 中按部署方说明将 API Key 留空。凭据安全警告即使 API Key 为可选项也不要公开你的私有服务地址、访问令牌或网关配置。服务地址与凭据一旦泄露任何拿到信息的人都能调用你的模型额度。第二步在 AIRI 中配置 n1n打开设置 → 服务商 → 聊天 → n1n。默认 Base URL 为https://api.n1n.ai/v1/。按 n1n 当前服务要求填写 API Key如果你的部署允许匿名访问则按部署方说明保留为空。这里有一个与源码相关的细节界面展示的默认 Base URL 带尾部斜杠https://api.n1n.ai/v1/而源码中的 schema 默认值是https://api.n1n.ai/v1不带斜杠。两者均可正常工作——校验器在构造模型列表请求时会自动兼容斜杠情况见下文验证机制。若你手动修改 Base URL建议保持以/v1结尾的标准 OpenAI 兼容路径格式。为什么 API Key 可以是可选项从源码实现看apiKey与baseUrl均为可选字段但服务商还定义了validationRequiredWhen(config) !!config.apiKey?.trim()也就是说仅当填入了非空 API Key 时才强制要求通过配置验证留空时匿名访问场景则跳过强制校验。这与文档中如果部署允许匿名访问则保留为空的指引完全一致。createProvider(config)最终以createOpenAI(config.apiKey || , config.baseUrl)构建客户端——匿名场景下以空字符串作为 API Key 传入具体是否可用取决于 n1n 部署方的访问策略。第三步验证配置配置填写完成后按以下顺序完成验证与启用Ping API点击此按钮测试网络、服务地址和凭据是否正确。该操作由服务商注册的验证器执行见下文会真实请求 n1n 的服务地址。选择模型测试成功后从模型列表中选择要使用的模型。再到设置 → 意识启用该服务商即可在意识能力中使用 n1n 的模型。n1n 服务商在 服务商注册表 中被导入并注册id: n1n排序order: 9其验证器由通用工厂createOpenAICompatibleValidators生成并启用了三项检查完整实现见 openai-compatible.tsConnectivity连通性检查向{baseUrl}/models发起 GET 请求若填写了 API Key 则附带Authorization: Bearer apiKey头请求带 10 秒超时服务端返回 5xx 或网络错误时判定失败对应 openai-compatible.ts。ModelList模型列表检查调用模型列表接口若返回的模型列表为空则判定失败对应 openai-compatible.ts。这解释了测试成功后即可选择模型的流程——模型下拉选项正是来自该接口。ChatCompletions聊天补全检查自动从模型列表挑选一个可用模型发送一条内容为ping的测试消息max_tokens: 16验证真实对话链路是否可用对应 openai-compatible.ts。除此之外服务商还注册了配置格式校验check-config校验 Base URL 必须是合法的绝对 URLnew URL可解析且包含 host以及填写了 API Key 时不能为空等规则见 openai-compatible.ts。同类的 OpenAI 兼容校验器在provider-inference包内被大量服务商复用并有对应的 校验器测试 覆盖n1n 的Ping API按钮正是这套校验体系的入口。排查验证失败怎么办验证失败时按以下顺序排查服务地址确认 Base URL 是否填写正确、可从运行 AIRI 的设备访问。注意连通性检查会真实请求{baseUrl}/models如果该地址在目标网络不可达如内网网关、需代理的地址会直接报网络错误。API Key确认凭据是否有效、是否过期。留意validationRequiredWhen逻辑——一旦填写了 API Key 就会走完整的三项检查错误的 Key 会在聊天补全检查中失败若服务允许匿名访问则按部署方说明将 API Key 留空不要填入无效字符串。访问策略确认 n1n 部署方当前是否对该地址、该模型开放访问包括模型白名单、匿名策略、限流等限制。另外需注意一个校验器的行为细节聊天补全检查会先尝试拉取模型列表并自动挑选一个模型跳过embed、tts等非聊天模型进行探测。如果 n1n 当前没有可用的聊天模型校验会失败并提示没有可用于验证的模型请手动配置模型后重试。此时应先在服务商配置中手动指定模型再重新执行 Ping 验证。相关参考n1n 接入文档本文原始依据n1n 服务商源码实现OpenAI 兼容校验器实现服务商注册表n1n 服务商分类与属性n1n 本地化文案该文档位于意识consciousness配置分区同目录下还有 OpenAI 接入文档、DeepSeek 接入文档 等同类的服务商配置指南可作为横向参考。【免费下载链接】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），仅供参考