AIRI 接入 Xiaomi MiMo 聊天模型从 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/airi本文围绕 AIRI 官方文档 docs/content/ko/docs/manual/config/providers/consciousness/mimo.md同步维护的英文版位于 docs/content/en/docs/manual/config/providers/consciousness/mimo.md简体中文版位于 docs/content/zh-Hans/docs/manual/config/providers/consciousness/mimo.md展开。AIRI 是一款自托管的陪伴型 AI 助手支持实时语音聊天、Web / macOS / Windows 多端运行Xiaomi MiMo 是其中内置的聊天模型提供者。读完本文你将掌握如何申请 MiMo API Key、如何在 AIRI 设置面板中完成提供者配置、AIRI 的自动校验与 Ping API 背后执行了哪些底层检查以及如何在「意识」模块中选定模型并解决常见故障。Xiaomi MiMo 在 AIRI 中的定位Xiaomi MiMo 在 AIRI 中作为聊天chat模型提供者出现同时拥有独立的 TTS语音合成与 STT语音识别服务商页面。也就是说MiMo 的能力在 AIRI 中被拆分为三块配置入口聊天模型配置于设置 → 提供者 → 聊天 → Xiaomi MiMoTTS配置于独立的语音Speech服务商页面详见 docs/content/ko/docs/manual/config/providers/speech/mimo.mdSTT配置于独立的转写Transcription服务商页面详见 docs/content/ko/docs/manual/config/providers/transcription/mimo.md。为什么选择 Xiaomi MiMo如果你希望使用同一个 MiMo 账户同时覆盖聊天与音频能力TTS / STT可以优先选择该提供者从而避免为不同能力分别申请、维护多套密钥。从源码结构看这三类能力也确实由独立的 provider 定义支撑见 packages/stage-ui/src/libs/providers/providers/index.ts 中的./mimo与./mimo-audio两个注册项providerMimo任务类型为chat即本文要配置的聊天模型提供者packages/stage-ui/src/libs/providers/providers/mimo/index.tsproviderMimoAudioSpeech任务类型为text-to-speechproviderMimoAudioTranscription任务类型为speech-to-text/asr/stt。三者共用同一个云端域名api.xiaomimimo.com且在 packages/stage-ui/src/libs/providers/attributes.ts 中均被标记为paid付费与cloud云端属性用于设置页的提供者目录筛选。第一步获取 API Key登录小米 MiMo 开放平台platform.xiaomimimo.com在控制台中创建 API Key将生成的 Key 复制并妥善保存后续在 AIRI 中直接填入。::: warning API Key 安全 不要把 API Key 提交到代码仓库、不要包含在截图里也不要分享给任何人。它等同于你账户的访问凭证泄露后可能导致额度被盗用。 :::在 AIRI 源码中apiKey字段的表单元数据被标记为type: password见 packages/stage-ui/src/libs/providers/providers/mimo/index.ts即配置界面以密码框形式录入且该字段为必填项z.string(API Key)见同文件 第 10-17 行。第二步在 AIRI 中配置 Xiaomi MiMo打开设置 → 提供者 → 聊天 → Xiaomi MiMo在API Key输入框中填入上一步申请的 KeyBase URL使用默认值https://api.xiaomimimo.com/v1/一般无需修改。配置项解析从 mimo/index.ts 的配置 Schema 可以看到两个核心字段及其默认行为字段类型必填默认值说明apiKeystring是无MiMo 平台签发的 API KeybaseUrlstring否https://api.xiaomimimo.com/v1/云端 API 端点一般保持默认baseUrl在 Schema 层直接以.default(https://api.xiaomimimo.com/v1/)兜底因此即使界面留空也会回落到官方端点。只有当小米调整端点地址时才有必要修改该值——这也与官方文档「排查」一节中「确认 Base URL 保持为默认值」的建议相互印证。底层提供者构造配置保存后AIRI 会通过createProvider构造实际的调用实例mimo/index.tscreateProvider(config) { const provider createXiaomi(config.apiKey, config.baseUrl) return { ...provider, chat(model: string, options?: ChatRequestOptions) { const request provider.chat(model) if (!options?.reasoning) return request return { ...request, thinking: { type: options.reasoning } } }, } }这里有两个值得注意的实现细节底层直接复用xsai-ext/providers/create的createXiaomi工厂说明 MiMo 走的是与 OpenAI 兼容的 HTTP 协议封装聊天请求支持reasoning推理开关当请求携带options.reasoning时会在请求体中加入thinking: { type: ... }字段。对应的能力声明为capabilities: { chat: { reasoning: { modes: [enabled, disabled] } } }见 mimo/index.ts即 MiMo 在 AIRI 中支持显式开启或关闭思考模式。该开关由「意识」设置中的 reasoning 选项控制持久化在本地存储键settings/consciousness/reasoning见 packages/stage-ui/src/stores/modules/consciousness-settings.ts。第三步验证配置AIRI 会在编辑配置的过程中自动进行有效性验证无需手动触发。验证逻辑由validationRequiredWhen决定只要apiKey非空白!!config.apiKey?.trim()见 mimo/index.ts配置即进入自动校验流程。自动校验执行的三类检查MiMo 的校验器由createOpenAICompatibleValidators生成并显式声明了三项检查mimo/index.tsvalidators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.Connectivity, ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },其具体实现位于 packages/stage-ui/src/libs/providers/validators/openai-compatible.ts检查项校验器 ID底层动作配置检查openai-compatible:check-config校验 API Key 非空、Base URL 非空且为绝对 URL连通性检查openai-compatible:check-connectivity带Authorization: Bearer apiKey请求{baseUrl}/models10 秒超时HTTP 5xx 判为失败模型列表检查openai-compatible:check-model-list拉取模型列表并确认非空聊天补全检查openai-compatible:check-chat-completions以用户消息ping发起一次真实的generateText请求max_tokens: 16验证端到端可用性也就是说文档中的Ping API按钮对应的正是check-chat-completions这一类真实请求测试——它不仅验证网络连通还会实际发送一条最小化的聊天补全请求消息体为ping输出上限 16 token以确认该账户、该 Key 真正具备生成能力。为避免重复请求该检查结果会在一次校验会话内通过缓存与互斥锁Mutex复用见 openai-compatible.ts。校验状态机共五档见 packages/stage-ui/src/libs/providers/types.tsunconfigured未配置→validating校验中→configured已配置→invalid无效/bypassed跳过。只有当校验通过configured后后续的模型选择入口才会开放。选择模型校验通过后点击选择模型 →按钮即可跳转到设置 → 模块 → 意识Consciousness页面在此处选定提供者与具体模型。从 packages/stage-pages/src/pages/settings/modules/consciousness.vue 的实现可以看到「意识」页面的核心交互逻辑页面顶部以单选卡片RadioCardSimple横向列出所有已配置的聊天提供者切换提供者时通过watch(activeProvider, ...)自动调用loadModelsForProvider拉取该提供者的模型列表见 consciousness.vue模型列表加载失败时页面会展示错误容器并回退到手动模型 ID 输入框manual_model_name这正是官方文档「排查」一节所述「手动输入模型 ID」的界面入口见 consciousness.vue校验失败的提供者卡片会显示health_check_failed健康检查失败角标便于快速定位问题提供者见 consciousness.vue。切换模型时还会触发埋点trackModelSwitched并在 AIRI Card 中同步更新当前的 consciousness 配置见 consciousness.vue。第四步TTS / STT 同账户复用延伸如果你希望同一个 MiMo 账户同时承担语音合成与语音识别可分别在对应的服务商页面填入同一个 API Key。三个提供者的默认 Base URL 均为https://api.xiaomimimo.com/v1/而音频能力在底层请求中使用的鉴权头为api-key而非 Bearer并复用/chat/completions端点见 packages/stage-ui/src/libs/providers/providers/mimo-audio/index.ts。关于音频侧可选的模型与音色源码给出了明确清单可作为「意识」之外的能力参考TTS 模型默认mimo-v2.5-tts另含mimo-v2.5-tts-voicedesign按自然语言描述设计新音色、mimo-v2.5-tts-voiceclone基于 base64 音频样本克隆音色默认格式为wav见 mimo-audio/index.tsSTT 模型默认mimo-v2-omni另含mimo-v2.5标注上下文长度为 1M见 mimo-audio/index.ts。这些细节说明MiMo 在 AIRI 中是一整套「聊天 语音 转写」的多模态提供者族配置聊天模型只是第一步。常见问题排查官方文档给出了三条基础排查路径结合源码可以进一步细化API 校验Ping失败先确认 API Key 是否复制完整源码要求非空白才触发校验见 mimo/index.ts再确认 MiMo 账户状态是否正常额度、是否被禁用最后确认网络能否访问api.xiaomimimo.com——连通性检查对 HTTP 5xx 一律判为失败见 openai-compatible.ts若该端点返回 5xx 说明是服务端或网络问题而非 Key 问题。模型列表无法加载确认 Base URL 未被改动默认https://api.xiaomimimo.com/v1/因为模型列表通过{baseUrl}/models拉取若 BASE_URL 正确仍拉取失败可按官方建议在「意识」页面的手动输入框直接填写小米 MiMo 官方文档给出的精确模型 ID该回退输入框实现在 consciousness.vue。提示「未配置提供者」当「意识」页面没有任何聊天提供者卡片时说明尚未在设置 → 提供者 → 聊天中成功添加并保存 MiMo或校验未通过页面会显示引导链接跳转到提供者目录见 consciousness.vue。总结在 AIRI 中使用 Xiaomi MiMo 的完整链路为在小米 MiMo 开放平台创建 API Key在设置 → 提供者 → 聊天 → Xiaomi MiMo中填入 API KeyBase URL 保持默认https://api.xiaomimimo.com/v1/等待自动校验连通性 / 模型列表 / 真实聊天补全三项检查通过必要时用 Ping API 手动测试点击选择模型 →进入设置 → 模块 → 意识选定 MiMo 提供者与模型如需语音能力用同一账户在 TTS / STT 服务商页面完成对应配置。通过 mimo/index.ts 与 openai-compatible.ts 等源码可以看到MiMo 在 AIRI 中是一套完整的 OpenAI 兼容接入实现并额外封装了 reasoning 开关与多模态音频能力适合希望用单一账户统一聊天与语音体验的用户。【免费下载链接】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 接入 Xiaomi MiMo 聊天模型：从 API Key 获取到「意识」模块启用的完整配置指南
AIRI 接入 Xiaomi MiMo 聊天模型从 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/airi本文围绕 AIRI 官方文档 docs/content/ko/docs/manual/config/providers/consciousness/mimo.md同步维护的英文版位于 docs/content/en/docs/manual/config/providers/consciousness/mimo.md简体中文版位于 docs/content/zh-Hans/docs/manual/config/providers/consciousness/mimo.md展开。AIRI 是一款自托管的陪伴型 AI 助手支持实时语音聊天、Web / macOS / Windows 多端运行Xiaomi MiMo 是其中内置的聊天模型提供者。读完本文你将掌握如何申请 MiMo API Key、如何在 AIRI 设置面板中完成提供者配置、AIRI 的自动校验与 Ping API 背后执行了哪些底层检查以及如何在「意识」模块中选定模型并解决常见故障。Xiaomi MiMo 在 AIRI 中的定位Xiaomi MiMo 在 AIRI 中作为聊天chat模型提供者出现同时拥有独立的 TTS语音合成与 STT语音识别服务商页面。也就是说MiMo 的能力在 AIRI 中被拆分为三块配置入口聊天模型配置于设置 → 提供者 → 聊天 → Xiaomi MiMoTTS配置于独立的语音Speech服务商页面详见 docs/content/ko/docs/manual/config/providers/speech/mimo.mdSTT配置于独立的转写Transcription服务商页面详见 docs/content/ko/docs/manual/config/providers/transcription/mimo.md。为什么选择 Xiaomi MiMo如果你希望使用同一个 MiMo 账户同时覆盖聊天与音频能力TTS / STT可以优先选择该提供者从而避免为不同能力分别申请、维护多套密钥。从源码结构看这三类能力也确实由独立的 provider 定义支撑见 packages/stage-ui/src/libs/providers/providers/index.ts 中的./mimo与./mimo-audio两个注册项providerMimo任务类型为chat即本文要配置的聊天模型提供者packages/stage-ui/src/libs/providers/providers/mimo/index.tsproviderMimoAudioSpeech任务类型为text-to-speechproviderMimoAudioTranscription任务类型为speech-to-text/asr/stt。三者共用同一个云端域名api.xiaomimimo.com且在 packages/stage-ui/src/libs/providers/attributes.ts 中均被标记为paid付费与cloud云端属性用于设置页的提供者目录筛选。第一步获取 API Key登录小米 MiMo 开放平台platform.xiaomimimo.com在控制台中创建 API Key将生成的 Key 复制并妥善保存后续在 AIRI 中直接填入。::: warning API Key 安全 不要把 API Key 提交到代码仓库、不要包含在截图里也不要分享给任何人。它等同于你账户的访问凭证泄露后可能导致额度被盗用。 :::在 AIRI 源码中apiKey字段的表单元数据被标记为type: password见 packages/stage-ui/src/libs/providers/providers/mimo/index.ts即配置界面以密码框形式录入且该字段为必填项z.string(API Key)见同文件 第 10-17 行。第二步在 AIRI 中配置 Xiaomi MiMo打开设置 → 提供者 → 聊天 → Xiaomi MiMo在API Key输入框中填入上一步申请的 KeyBase URL使用默认值https://api.xiaomimimo.com/v1/一般无需修改。配置项解析从 mimo/index.ts 的配置 Schema 可以看到两个核心字段及其默认行为字段类型必填默认值说明apiKeystring是无MiMo 平台签发的 API KeybaseUrlstring否https://api.xiaomimimo.com/v1/云端 API 端点一般保持默认baseUrl在 Schema 层直接以.default(https://api.xiaomimimo.com/v1/)兜底因此即使界面留空也会回落到官方端点。只有当小米调整端点地址时才有必要修改该值——这也与官方文档「排查」一节中「确认 Base URL 保持为默认值」的建议相互印证。底层提供者构造配置保存后AIRI 会通过createProvider构造实际的调用实例mimo/index.tscreateProvider(config) { const provider createXiaomi(config.apiKey, config.baseUrl) return { ...provider, chat(model: string, options?: ChatRequestOptions) { const request provider.chat(model) if (!options?.reasoning) return request return { ...request, thinking: { type: options.reasoning } } }, } }这里有两个值得注意的实现细节底层直接复用xsai-ext/providers/create的createXiaomi工厂说明 MiMo 走的是与 OpenAI 兼容的 HTTP 协议封装聊天请求支持reasoning推理开关当请求携带options.reasoning时会在请求体中加入thinking: { type: ... }字段。对应的能力声明为capabilities: { chat: { reasoning: { modes: [enabled, disabled] } } }见 mimo/index.ts即 MiMo 在 AIRI 中支持显式开启或关闭思考模式。该开关由「意识」设置中的 reasoning 选项控制持久化在本地存储键settings/consciousness/reasoning见 packages/stage-ui/src/stores/modules/consciousness-settings.ts。第三步验证配置AIRI 会在编辑配置的过程中自动进行有效性验证无需手动触发。验证逻辑由validationRequiredWhen决定只要apiKey非空白!!config.apiKey?.trim()见 mimo/index.ts配置即进入自动校验流程。自动校验执行的三类检查MiMo 的校验器由createOpenAICompatibleValidators生成并显式声明了三项检查mimo/index.tsvalidators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.Connectivity, ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },其具体实现位于 packages/stage-ui/src/libs/providers/validators/openai-compatible.ts检查项校验器 ID底层动作配置检查openai-compatible:check-config校验 API Key 非空、Base URL 非空且为绝对 URL连通性检查openai-compatible:check-connectivity带Authorization: Bearer apiKey请求{baseUrl}/models10 秒超时HTTP 5xx 判为失败模型列表检查openai-compatible:check-model-list拉取模型列表并确认非空聊天补全检查openai-compatible:check-chat-completions以用户消息ping发起一次真实的generateText请求max_tokens: 16验证端到端可用性也就是说文档中的Ping API按钮对应的正是check-chat-completions这一类真实请求测试——它不仅验证网络连通还会实际发送一条最小化的聊天补全请求消息体为ping输出上限 16 token以确认该账户、该 Key 真正具备生成能力。为避免重复请求该检查结果会在一次校验会话内通过缓存与互斥锁Mutex复用见 openai-compatible.ts。校验状态机共五档见 packages/stage-ui/src/libs/providers/types.tsunconfigured未配置→validating校验中→configured已配置→invalid无效/bypassed跳过。只有当校验通过configured后后续的模型选择入口才会开放。选择模型校验通过后点击选择模型 →按钮即可跳转到设置 → 模块 → 意识Consciousness页面在此处选定提供者与具体模型。从 packages/stage-pages/src/pages/settings/modules/consciousness.vue 的实现可以看到「意识」页面的核心交互逻辑页面顶部以单选卡片RadioCardSimple横向列出所有已配置的聊天提供者切换提供者时通过watch(activeProvider, ...)自动调用loadModelsForProvider拉取该提供者的模型列表见 consciousness.vue模型列表加载失败时页面会展示错误容器并回退到手动模型 ID 输入框manual_model_name这正是官方文档「排查」一节所述「手动输入模型 ID」的界面入口见 consciousness.vue校验失败的提供者卡片会显示health_check_failed健康检查失败角标便于快速定位问题提供者见 consciousness.vue。切换模型时还会触发埋点trackModelSwitched并在 AIRI Card 中同步更新当前的 consciousness 配置见 consciousness.vue。第四步TTS / STT 同账户复用延伸如果你希望同一个 MiMo 账户同时承担语音合成与语音识别可分别在对应的服务商页面填入同一个 API Key。三个提供者的默认 Base URL 均为https://api.xiaomimimo.com/v1/而音频能力在底层请求中使用的鉴权头为api-key而非 Bearer并复用/chat/completions端点见 packages/stage-ui/src/libs/providers/providers/mimo-audio/index.ts。关于音频侧可选的模型与音色源码给出了明确清单可作为「意识」之外的能力参考TTS 模型默认mimo-v2.5-tts另含mimo-v2.5-tts-voicedesign按自然语言描述设计新音色、mimo-v2.5-tts-voiceclone基于 base64 音频样本克隆音色默认格式为wav见 mimo-audio/index.tsSTT 模型默认mimo-v2-omni另含mimo-v2.5标注上下文长度为 1M见 mimo-audio/index.ts。这些细节说明MiMo 在 AIRI 中是一整套「聊天 语音 转写」的多模态提供者族配置聊天模型只是第一步。常见问题排查官方文档给出了三条基础排查路径结合源码可以进一步细化API 校验Ping失败先确认 API Key 是否复制完整源码要求非空白才触发校验见 mimo/index.ts再确认 MiMo 账户状态是否正常额度、是否被禁用最后确认网络能否访问api.xiaomimimo.com——连通性检查对 HTTP 5xx 一律判为失败见 openai-compatible.ts若该端点返回 5xx 说明是服务端或网络问题而非 Key 问题。模型列表无法加载确认 Base URL 未被改动默认https://api.xiaomimimo.com/v1/因为模型列表通过{baseUrl}/models拉取若 BASE_URL 正确仍拉取失败可按官方建议在「意识」页面的手动输入框直接填写小米 MiMo 官方文档给出的精确模型 ID该回退输入框实现在 consciousness.vue。提示「未配置提供者」当「意识」页面没有任何聊天提供者卡片时说明尚未在设置 → 提供者 → 聊天中成功添加并保存 MiMo或校验未通过页面会显示引导链接跳转到提供者目录见 consciousness.vue。总结在 AIRI 中使用 Xiaomi MiMo 的完整链路为在小米 MiMo 开放平台创建 API Key在设置 → 提供者 → 聊天 → Xiaomi MiMo中填入 API KeyBase URL 保持默认https://api.xiaomimimo.com/v1/等待自动校验连通性 / 模型列表 / 真实聊天补全三项检查通过必要时用 Ping API 手动测试点击选择模型 →进入设置 → 模块 → 意识选定 MiMo 提供者与模型如需语音能力用同一账户在 TTS / STT 服务商页面完成对应配置。通过 mimo/index.ts 与 openai-compatible.ts 等源码可以看到MiMo 在 AIRI 中是一套完整的 OpenAI 兼容接入实现并额外封装了 reasoning 开关与多模态音频能力适合希望用单一账户统一聊天与语音体验的用户。【免费下载链接】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），仅供参考