AIRI 接入 Novita AI 聊天模型OpenAI 兼容提供者配置与校验机制详解【免费下载链接】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本文是一份面向 AIRI 用户的实操指南讲解如何将 Novita AI 作为「意识Consciousness」模块的聊天Chat提供者接入 AIRI从 API Key 申请、界面配置、Base URL 约定到配置自动校验与问题排查的完整流程。读完本文后你将掌握在 AIRI 中配置 OpenAI 兼容云服务提供者的标准方法并理解背后的源码级校验原理从而能够快速复用到其他同类提供者上。Novita AI 与 AIRI 的接入定位AIRI 的提供者体系中Novita AI内部提供者 ID 为novita-ai被定义为「聊天提供者」tasks: [chat]其文档 front matter 标注了is_openai_compatible: true——这意味着它走的是 OpenAI 兼容协议通道而非原生通道。选择 Novita AI 的核心理由很直接如果你已经在 Novita AI 平台上管理模型服务那么现有的服务商 API Key 可以直接在 AIRI 中复用无需额外申请其他平台的密钥。从源码分类来看Novita 被归入「付费云服务」pricing 为paid、deployment 为cloud见 packages/stage-ui/src/libs/providers/attributes.ts在提供者目录的筛选器里会以「付费 / 云端」标签呈现。在界面文案层面提供者的显示名称与描述由 i18n 国际化键驱动韩语环境下显示为标题Novita、描述novita.ai见 packages/i18n/src/locales/ko/settings.yaml中文、日文等其他语言版本的同名文档位于 docs/content/zh-Hans/docs/manual/config/providers/consciousness/novita.md 等路径下。第一步申请 API Key在使用前你需要先在 Novita AI 控制台创建 API Key流程如下打开 Novita AI 控制台dashboard 页面。在API Keys页面中创建新的 API Key。复制密钥并妥善保管在安全的位置。⚠️API Key 安全红线不要把 API Key 提交到代码仓库、不要出现在截图里、更不要分享给任何人。一旦怀疑密钥泄露应立即在 Novita AI 控制台作废旧密钥并重新签发。第二步在 AIRI 中配置 Novita配置路径为设置 → 提供者 → 聊天 → Novita具体操作进入该页面后在基本设置中粘贴你的 API Key。保持默认 Base URL 不变https://api.novita.ai/openai/。Base URL 之所以可以直接沿用默认值是因为 AIRI 的 Novita 提供者定义中把baseUrl设为可选字段并带默认值。从 packages/stage-ui/src/libs/providers/providers/novita-ai/index.ts 的配置 schema 可以看到const novitaConfigSchema z.object({ apiKey: z.string(API Key), baseUrl: z.string(Base URL).optional().default(https://api.novita.ai/openai/), })其中apiKey是必填项baseUrl不填时自动回落到官方 OpenAI 兼容端点。UI 上 apiKey 字段以密码框type: password形式展示避免明文暴露。创建 Provider 时AIRI 通过xsai-ext/providers/create的createNovita(config.apiKey, config.baseUrl)构造底层客户端实例见 packages/stage-ui/src/libs/providers/providers/novita-ai/index.ts。值得注意的是其能力声明capabilities: { chat: { reasoning: { modes: [enabled, disabled] } } },即 Novita 通道支持「思维链/推理」开关。对应的chat包装方法会把enableThinking注入请求当推理选项为enabled时开启为disabled或未指定时保持默认见 packages/stage-ui/src/libs/providers/providers/novita-ai/index.ts。这意味着你在意识模块中可以通过开关控制模型是否输出思考过程。第三步验证配置是否生效AIRI 会在编辑配置的过程中自动执行校验无需手动触发设置有效性校验当表单中出现Ping API按钮时可直接用它发起一次真实请求测试连通性。选择模型 →校验通过后点击该按钮会跳转到设置 → 模块 → 意识在那里选择提供者与具体模型。从源码层面看Novita 的校验器来自createOpenAICompatibleValidators并启用了三项检查见 packages/stage-ui/src/libs/providers/providers/novita-ai/index.tsvalidationRequiredWhen(config) { return !!config.apiKey?.trim() }, validators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.Connectivity, ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },validationRequiredWhen规定只要 apiKey 非空去空白后该校验器即被激活。这三项检查在 packages/stage-ui/src/libs/providers/types.ts 中定义其底层实现位于 packages/stage-ui/src/libs/providers/validators/openai-compatible.ts执行逻辑如下检查项枚举值实际行为配置检查check-config校验 apiKey 非空、Base URL 为合法的绝对 URLnew URL()解析 host 判定连通性检查check-connectivity向{baseUrl}/models发起 GET 请求携带Authorization: Bearer apiKey10 秒超时AbortControllerHTTP 5xx 视为服务端错误模型列表检查check-model-list通过listModels拉取模型列表要求非空聊天补全检查check-chat-completions调用generateText发送一条user(ping)探测消息max_tokens固定为 16并对结果做互斥缓存Mutex避免重复请求这解释了「Ping API」的本质它不是一次简单的网络探测而是模拟一次最小化聊天请求连同一个探针消息与 token 上限能同时验证认证、配额与模型可用性而连通性检查只负责轻量探测/models端点。校验结果的缓存机制见 openai-compatible.ts保证在配置编辑过程中反复触发校验时不会向 Novita 发起重复请求。问题排查若 API 校验失败请按以下顺序逐项排查API Key 是否正确确认粘贴时没有多余空格或缺失字符校验器会先trim()再判断。账户余额或配额是否充足Novita 是付费云服务欠费或配额耗尽会导致请求被拒。请求限流Rate Limit短时间内高频校验可能触发限流可稍等片刻重试。网络连通性确认当前网络可以访问https://api.novita.ai/openai/校验器对网络错误会直接判定连通性失败。另一个常见现象是模型列表加载失败当 AIRI 无法自动拉取 Novita AI 的模型目录时可以在意识页面手动输入 Novita AI 提供的精确模型 ID。该场景与「模型列表检查」的实现相呼应——如果/models拉取异常或返回空列表校验器会报出no models found此时手动指定模型 ID 是绕过列表依赖的最稳妥方式。小结在 AIRI 中接入 Novita AI 本质上是一个「标准 OpenAI 兼容提供者」的接入流程申请 API Key → 在提供者设置页填入密钥并保留默认 Base URL → 依赖自动校验确认连通性、模型列表与聊天补全三项能力 → 在意识模块中选择模型。理解novita-ai提供者定义index.ts与其背后通用的 OpenAI 兼容校验器openai-compatible.ts还能帮助你举一反三快速掌握同一目录下其他 OpenAI 兼容提供者如 DeepSeek、Moonshot、OpenRouter 等的配置与排错套路。【免费下载链接】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），仅供参考