在 AIRI 中配置 AIHubMix 聊天模型从 API Key 获取到验证与排障【免费下载链接】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/airiAIHubMix 是 AIRI 中开箱即用的 OpenAI 兼容聊天模型服务商之一。本文以 aihubmix.md 为核心完整讲解如何获取 API Key、在设置 → 服务商Providers→ 聊天Chat中完成配置、利用 AIRI 的自动校验与 Ping API 进行验证并深入源码解释校验链路的底层实现。读完本文你将掌握在 AIRI 中接入 AIHubMix 的完整流程并能在模型列表无法加载时自主排障。AIHubMix 在 AIRI 中扮演什么角色AIHubMix 是 AIRI 的聚合式 API 服务商接入之一职责有两项提供聊天模型通过你的 AIHubMix 账户与 API Key让 AIRI 的意识Consciousness模块能够调用 AIHubMix 提供的对话模型列出账户可用模型配置验证成功后AIRI 会自动拉取该账户下可用的模型列表供你在意识页面选择。从源码看AIHubMix 在 AIRI 中被注册为一个标准服务商定义Provider Definition见 packages/stage-ui/src/libs/providers/providers/aihubmix/index.tsexport const providerAIHubMix defineProviderAIHubMixConfig({ id: aihubmix, order: 1, name: AIHubMix, tasks: [chat], capabilities: { chat: { reasoning: { modes: [enabled, disabled] } } }, ... })其中id: aihubmix是内部唯一标识tasks: [chat]表明它只承担聊天对话任务capabilities声明该服务商支持推理模式的开关能力。该定义通过 packages/stage-ui/src/libs/providers/providers/index.ts 中的import ./aihubmix被全局注册因此会在设置页的服务商目录中直接出现。为什么选 AIHubMix如果你的 AIHubMix 账户中已有想用的模型希望用一个 API Key 统一调用就可以选择它。i18n 文案中的描述为 https://aihubmix.com (10% off)见 packages/i18n/src/locales/en/settings.yaml实际可用性与网络环境、计费方式和服务商策略有关。第一步获取 API Key登录 AIHubMix 官网进入控制台Console在控制台中创建一个 API Key复制该 Key 并妥善保管。API Key 安全警告不要将 API Key 提交到代码仓库、不要出现在截图中、不要分享给任何人。一旦疑似泄露应立即在 AIHubMix 控制台吊销并重新生成。第二步在 AIRI 中配置打开设置Settings→ 服务商Providers→ 聊天Chat→ AIHubMix填写以下字段字段必填默认值 / 说明API Key是在 AIHubMix 控制台创建的 Key输入框类型为密码框type: password不会明文展示Base URL否默认https://aihubmix.com/v1/通常无需修改这两个字段在源码中有对应的 Zod 校验 Schemaaihubmix/index.tsconst aihubmixConfigSchema z.object({ apiKey: z.string(API Key), baseUrl: z .string(Base URL) .optional() .default(https://aihubmix.com/v1/), })apiKey必填为空时配置校验会直接报错baseUrl可选默认值即https://aihubmix.com/v1/。如果你在其它服务商如 302.AI之间切换过配置务必确认此处没有被改成其它地址。配置后 AIRI 实际做了什么当你在表单中填入配置并保存后AIRI 会调用createProvider(config)生成一个融合了三种能力的服务商实例aihubmix/index.tscreateProvider(config) { const provider merge( createChatProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createEmbedProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createModelProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), ) ... }即同时注册了**聊天chat、嵌入embed、模型列表model**三种 OpenAI 兼容端点。此外AIHubMix 对推理reasoning参数做了特殊映射chat(model: string, options?: ChatRequestOptions) { const request provider.chat(model) if (!options?.reasoning) return request return { ...request, reasoningEffort: options.reasoning enabled ? medium : none } }也就是说当你在意识页面把某个模型的推理模式设为enabled时AIRI 会向 AIHubMix 发送reasoningEffort: medium设为disabled时发送reasoningEffort: none。第三步验证配置AIRI 会在你编辑配置的过程中自动进行校验Validate configuration自动校验编辑配置时实时触发。校验通过后界面上会出现Ping API按钮点击即可发起一次真实的在线请求测试Select Model →选择模型校验成功后点击该按钮会跳转到设置 → 模块Modules→ 意识Consciousness在那里选择服务商和具体模型。校验链路的源码级说明AIHubMix 复用了 OpenAI 兼容服务商的通用校验器validators/openai-compatible.ts并显式声明需要做两类运行时检查aihubmix/index.tsvalidators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },整个验证计划由 validators/run.ts 编排分为**配置校验config与服务商运行时校验provider**两个阶段任何一步失败都会在界面上显示具体原因配置校验openai-compatible:check-config本地完成不发起网络请求。检查 API Key 是否为空、Base URL 是否为空、Base URL 是否为合法的绝对 URLnew URL(...)是否能解析出 host。配置不合法时后续运行时校验会被直接跳过界面提示 Fix configuration checks first.模型列表校验openai-compatible:check-model-list调用模型列表端点拉取GET {baseUrl}/models要求返回的模型数组非空否则报 Model list check failed: no models found聊天补全校验openai-compatible:check-chat-completions自动挑选一个可用模型会跳过embed、tts、models/gemini-2.5-pro等不适合用于 ping 的模型发送一条内容为ping的测试消息并带上max_tokens: 16的输出上限部分 OpenAI 兼容服务商不接受低于 16 的输出限制。返回 400 或 2xx 都视为服务商可响应。触发条件validationRequiredWhen(config)的实现是!!config.apiKey?.trim()aihubmix/index.ts——只有填入了非空白 API Key 时才会真正执行校验。所以如果你发现验证一直不出现先确认 API Key 是否已填写。Ping API 与校验结果的使用校验执行完成后每个步骤的状态会依次呈现为idle → validating → valid/invalid状态机定义见 validators/run.ts失败的步骤会附带reason文本。Ping API按钮触发的是同一套校验流程的实时请求方便你在不离开设置页的情况下确认网络连通性、Key 有效性与模型列表可达性。校验全部通过后进入设置 → 意识页面对应页面实现见 packages/stage-pages/src/pages/settings/modules/consciousness.vue从服务商下拉中选择AIHubMix再选择你要使用的模型并启用即可。设置页面对应的配置编辑页面见 packages/stage-pages/src/pages/settings/providers/chat/[providerId].vue。排障指南Ping API 失败按以下顺序排查API Key 是否正确确认复制时没有多余空格源码会先trim()再做校验与请求且该 Key 没有被吊销账户余额AIHubMix 为计费 API余额不足时请求会被服务商拒绝网络连接确认当前网络能够访问 AIHubMix 的端点尤其注意代理、防火墙、地区网络策略。模型列表无法加载确认Base URL 未被改动保持默认值https://aihubmix.com/v1/源码中该字段带.default(...)清空后会自动回落到默认值如果列表仍无法拉取可以直接在意识Consciousness页面手动输入 AIHubMix 提供的精确模型 ID绕过模型列表拉取。延伸阅读服务商核心实现packages/stage-ui/src/libs/providers/providers/aihubmix/index.tsOpenAI 兼容校验器packages/stage-ui/src/libs/providers/validators/openai-compatible.ts校验流程编排packages/stage-ui/src/libs/providers/validators/run.ts服务商注册总表packages/stage-ui/src/libs/providers/providers/index.ts意识模块页面packages/stage-pages/src/pages/settings/modules/consciousness.vue相关服务商对照文档302ai.md同样属于 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 在 AIRI 中配置 AIHubMix 聊天模型：从 API Key 获取到验证与排障
在 AIRI 中配置 AIHubMix 聊天模型从 API Key 获取到验证与排障【免费下载链接】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/airiAIHubMix 是 AIRI 中开箱即用的 OpenAI 兼容聊天模型服务商之一。本文以 aihubmix.md 为核心完整讲解如何获取 API Key、在设置 → 服务商Providers→ 聊天Chat中完成配置、利用 AIRI 的自动校验与 Ping API 进行验证并深入源码解释校验链路的底层实现。读完本文你将掌握在 AIRI 中接入 AIHubMix 的完整流程并能在模型列表无法加载时自主排障。AIHubMix 在 AIRI 中扮演什么角色AIHubMix 是 AIRI 的聚合式 API 服务商接入之一职责有两项提供聊天模型通过你的 AIHubMix 账户与 API Key让 AIRI 的意识Consciousness模块能够调用 AIHubMix 提供的对话模型列出账户可用模型配置验证成功后AIRI 会自动拉取该账户下可用的模型列表供你在意识页面选择。从源码看AIHubMix 在 AIRI 中被注册为一个标准服务商定义Provider Definition见 packages/stage-ui/src/libs/providers/providers/aihubmix/index.tsexport const providerAIHubMix defineProviderAIHubMixConfig({ id: aihubmix, order: 1, name: AIHubMix, tasks: [chat], capabilities: { chat: { reasoning: { modes: [enabled, disabled] } } }, ... })其中id: aihubmix是内部唯一标识tasks: [chat]表明它只承担聊天对话任务capabilities声明该服务商支持推理模式的开关能力。该定义通过 packages/stage-ui/src/libs/providers/providers/index.ts 中的import ./aihubmix被全局注册因此会在设置页的服务商目录中直接出现。为什么选 AIHubMix如果你的 AIHubMix 账户中已有想用的模型希望用一个 API Key 统一调用就可以选择它。i18n 文案中的描述为 https://aihubmix.com (10% off)见 packages/i18n/src/locales/en/settings.yaml实际可用性与网络环境、计费方式和服务商策略有关。第一步获取 API Key登录 AIHubMix 官网进入控制台Console在控制台中创建一个 API Key复制该 Key 并妥善保管。API Key 安全警告不要将 API Key 提交到代码仓库、不要出现在截图中、不要分享给任何人。一旦疑似泄露应立即在 AIHubMix 控制台吊销并重新生成。第二步在 AIRI 中配置打开设置Settings→ 服务商Providers→ 聊天Chat→ AIHubMix填写以下字段字段必填默认值 / 说明API Key是在 AIHubMix 控制台创建的 Key输入框类型为密码框type: password不会明文展示Base URL否默认https://aihubmix.com/v1/通常无需修改这两个字段在源码中有对应的 Zod 校验 Schemaaihubmix/index.tsconst aihubmixConfigSchema z.object({ apiKey: z.string(API Key), baseUrl: z .string(Base URL) .optional() .default(https://aihubmix.com/v1/), })apiKey必填为空时配置校验会直接报错baseUrl可选默认值即https://aihubmix.com/v1/。如果你在其它服务商如 302.AI之间切换过配置务必确认此处没有被改成其它地址。配置后 AIRI 实际做了什么当你在表单中填入配置并保存后AIRI 会调用createProvider(config)生成一个融合了三种能力的服务商实例aihubmix/index.tscreateProvider(config) { const provider merge( createChatProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createEmbedProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createModelProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), ) ... }即同时注册了**聊天chat、嵌入embed、模型列表model**三种 OpenAI 兼容端点。此外AIHubMix 对推理reasoning参数做了特殊映射chat(model: string, options?: ChatRequestOptions) { const request provider.chat(model) if (!options?.reasoning) return request return { ...request, reasoningEffort: options.reasoning enabled ? medium : none } }也就是说当你在意识页面把某个模型的推理模式设为enabled时AIRI 会向 AIHubMix 发送reasoningEffort: medium设为disabled时发送reasoningEffort: none。第三步验证配置AIRI 会在你编辑配置的过程中自动进行校验Validate configuration自动校验编辑配置时实时触发。校验通过后界面上会出现Ping API按钮点击即可发起一次真实的在线请求测试Select Model →选择模型校验成功后点击该按钮会跳转到设置 → 模块Modules→ 意识Consciousness在那里选择服务商和具体模型。校验链路的源码级说明AIHubMix 复用了 OpenAI 兼容服务商的通用校验器validators/openai-compatible.ts并显式声明需要做两类运行时检查aihubmix/index.tsvalidators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },整个验证计划由 validators/run.ts 编排分为**配置校验config与服务商运行时校验provider**两个阶段任何一步失败都会在界面上显示具体原因配置校验openai-compatible:check-config本地完成不发起网络请求。检查 API Key 是否为空、Base URL 是否为空、Base URL 是否为合法的绝对 URLnew URL(...)是否能解析出 host。配置不合法时后续运行时校验会被直接跳过界面提示 Fix configuration checks first.模型列表校验openai-compatible:check-model-list调用模型列表端点拉取GET {baseUrl}/models要求返回的模型数组非空否则报 Model list check failed: no models found聊天补全校验openai-compatible:check-chat-completions自动挑选一个可用模型会跳过embed、tts、models/gemini-2.5-pro等不适合用于 ping 的模型发送一条内容为ping的测试消息并带上max_tokens: 16的输出上限部分 OpenAI 兼容服务商不接受低于 16 的输出限制。返回 400 或 2xx 都视为服务商可响应。触发条件validationRequiredWhen(config)的实现是!!config.apiKey?.trim()aihubmix/index.ts——只有填入了非空白 API Key 时才会真正执行校验。所以如果你发现验证一直不出现先确认 API Key 是否已填写。Ping API 与校验结果的使用校验执行完成后每个步骤的状态会依次呈现为idle → validating → valid/invalid状态机定义见 validators/run.ts失败的步骤会附带reason文本。Ping API按钮触发的是同一套校验流程的实时请求方便你在不离开设置页的情况下确认网络连通性、Key 有效性与模型列表可达性。校验全部通过后进入设置 → 意识页面对应页面实现见 packages/stage-pages/src/pages/settings/modules/consciousness.vue从服务商下拉中选择AIHubMix再选择你要使用的模型并启用即可。设置页面对应的配置编辑页面见 packages/stage-pages/src/pages/settings/providers/chat/[providerId].vue。排障指南Ping API 失败按以下顺序排查API Key 是否正确确认复制时没有多余空格源码会先trim()再做校验与请求且该 Key 没有被吊销账户余额AIHubMix 为计费 API余额不足时请求会被服务商拒绝网络连接确认当前网络能够访问 AIHubMix 的端点尤其注意代理、防火墙、地区网络策略。模型列表无法加载确认Base URL 未被改动保持默认值https://aihubmix.com/v1/源码中该字段带.default(...)清空后会自动回落到默认值如果列表仍无法拉取可以直接在意识Consciousness页面手动输入 AIHubMix 提供的精确模型 ID绕过模型列表拉取。延伸阅读服务商核心实现packages/stage-ui/src/libs/providers/providers/aihubmix/index.tsOpenAI 兼容校验器packages/stage-ui/src/libs/providers/validators/openai-compatible.ts校验流程编排packages/stage-ui/src/libs/providers/validators/run.ts服务商注册总表packages/stage-ui/src/libs/providers/providers/index.ts意识模块页面packages/stage-pages/src/pages/settings/modules/consciousness.vue相关服务商对照文档302ai.md同样属于 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考