ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

AIRI 接入小米 MiMo:聊天模型服务商配置全指南

AIRI 接入小米 MiMo:聊天模型服务商配置全指南 AIRI 接入小米 MiMo聊天模型服务商配置全指南【免费下载链接】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小米 MiMoXiaomi MiMo是 AIRI 内置的云端服务商之一为 AIRI 提供 OpenAI 兼容的聊天Chat能力并配套独立的语音合成TTS与语音识别ASR/STT服务商页面。本篇指南基于 AIRI 官方配置文档docs/content/zh-Hans/docs/manual/config/providers/consciousness/mimo.md结合 provider-inference 包的源码实现完整讲解从获取 API Key、在设置界面完成配置、Ping 验证到常见问题排查的端到端流程并深入说明 MiMo 服务商在 AIRI 底层是如何被定义、校验与调用的。为什么在 AIRI 中选择小米 MiMoAIRI 将意识意识/Consciousness层的聊天模型与音频能力分开编排。MiMo 的特殊之处在于你可以在同一个 MiMo 账户下同时使用聊天、语音合成与语音识别三类能力无需分别注册多家服务商。官方文档在说明选择理由时指出如果你希望在同一 MiMo 账户下使用聊天和音频能力可以选择它。从源码注册表看MiMo 确实被拆成了三个独立定义并统一注册providerMimo聊天id 为mimoproviderMimoAudioSpeech语音合成id 为mimo-audio-speechproviderMimoAudioTranscription语音识别id 为mimo-audio-transcription三者统一注册在 packages/provider-inference/src/providers/index.ts 的portableProviderDefinitions列表中共享api.xiaomimimo.com这一 API 域名见 packages/i18n/src/locales/zh-Hans/settings.yaml。第一步获取 API Key打开并登录小米 MiMo 平台创建 API Key。复制 API Key 并妥善保存。::: warning API Key 安全 不要将 API Key 提交到仓库、截图或发送给他人。语音识别场景下待识别音频会被发送到服务商请先确认你的数据处理要求声音克隆场景下只上传你有权使用的声音样本。 :::第二步在 AIRI 中配置聊天服务商打开设置 → 服务商 → 聊天 → Xiaomi MiMo填写API Key。默认 Base URL 为https://api.xiaomimimo.com/v1/。配置项的源码定义从源码看聊天服务商的配置结构由 zod schema 严格约束packages/provider-inference/src/providers/cloud/mimo/index.tsconst mimoConfigSchema z.object({ apiKey: z.string(API Key), baseUrl: z .string(Base URL) .optional() .default(https://api.xiaomimimo.com/v1/), })两个配置项的含义如下配置项必填默认值说明apiKey是无小米 MiMo 平台创建的 API Key界面中以密码类型type: password输入框展示baseUrl否https://api.xiaomimimo.com/v1/OpenAI 兼容接口的 Base URL一般保持默认即可createProviderConfig会为这两个字段附加本地化的标签、说明与占位符mimo/index.ts因此在中文界面下会显示为中文提示。聊天请求的底层封装createProvider内部通过createXiaomi(config.apiKey, config.baseUrl)创建底层客户端并在此基础上包装了chat方法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 } } }, } }这段实现揭示了一个关键能力MiMo 聊天服务商支持思维链reasoning开关。当调用方传入options.reasoning时AIRI 会在请求中附加thinking: { type: options.reasoning }而capabilities声明支持的取值模式为[enabled, disabled]mimo/index.ts。这对应了模型在深度思考与即时响应两种状态间的切换你可以据此让 MiMo 在复杂推理与低延迟场景之间灵活切换。第三步验证配置配置完成后按以下顺序验证Ping API点击此按钮测试网络是否连通以及 API Key 是否填写正确。选择模型测试成功后选择模型再到设置 → 意识启用。Ping 验证背后的校验链Ping API 不是简单的连通性检查而是由一组 OpenAI 兼容校验器组成的完整验证流程mimo/index.tsvalidators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.Connectivity, ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },校验链包含三个阶段Connectivity连通性验证能否访问https://api.xiaomimimo.com/v1/且网络通畅ModelList模型列表拉取服务商可用模型列表供选择模型步骤使用ChatCompletions实际对话发送一次真实的聊天补全请求验证 API Key 与配置确实可用。因此点击Ping API成功后模型列表会自动加载随后即可在设置 → 意识中选择启用 MiMo 模型作为意识层驱动。何时触发校验validationRequiredWhen表明只要apiKey非空白config.apiKey?.trim()有值服务商定义就会被要求执行上述校验mimo/index.ts。这意味着填写了 API Key 但 Base URL 使用默认值时保存即会触发校验无需手动额外操作。排查Ping API 失败时按以下顺序排查API Key确认已正确复制且无多余空格未过期或撤销账户状态确认账户已开通 API 使用权限网络连接确认当前网络可以访问api.xiaomimimo.com代理或防火墙配置未拦截。模型列表无法加载时确认Base URL 保持为默认值https://api.xiaomimimo.com/v1/或在意识页面输入小米 MiMo 提供的精确模型 ID。需要说明的是Base URL 只应在你确认服务商提供了其他 OpenAI 兼容地址时才修改随意改动会同时导致模型列表拉取与实际调用失败。扩展同一账户下的 TTS 与 STT 服务商文档开头提到 MiMo有独立的 TTS 与 STT 服务商页面这两个页面的官方配置指南分别为语音合成docs/content/zh-Hans/docs/manual/config/providers/speech/mimo.md设置 → 服务商 → 语音合成 → Xiaomi MiMo再到设置 → 发声启用语音识别docs/content/zh-Hans/docs/manual/config/providers/transcription/mimo.md设置 → 服务商 → 语音识别 → Xiaomi MiMo再到设置 → 听觉启用从 packages/provider-inference/src/providers/cloud/mimo-audio/index.ts 的实现可以看到三个服务商共享同一个 API Key 与 Base URL默认均为https://api.xiaomimimo.com/v1/在任意一个页面填写后其余页面可复用同一凭据。TTS 侧额外支持三种语音合成模式mimo-audio/index.tsmimo-v2.5-tts使用内置预设音色如中文音色冰糖茉莉苏打白桦英文音色 MiaChloeMiloDean以及中英通用的mimo_defaultmimo-v2.5-tts-voicedesign通过自然语言样式描述设计全新音色要求用户消息中提供样式提示词mimo-v2.5-tts-voiceclone基于 Base64 data URI 格式的音频样本克隆声音未提供样本时会直接抛出错误mimo-audio/index.ts。STT 侧则复用 MiMo 的原生多模态音频理解模型mimo-audio/index.tsmimo-v2-omni26 万 token 上下文与mimo-v2.5100 万 token 上下文。底层会把音频文件转为 data URI 后以input_audio消息格式发送到chat/completions端点mimo-audio/index.ts因此转写质量直接取决于所选多模态模型的音频理解能力。小结在 AIRI 中启用小米 MiMo 只需三步平台创建 API Key → 设置中填写并 Ping 验证 → 选择模型后在意识启用。得益于 OpenAI 兼容的实现方式MiMo 与 AIRI 的校验体系连通性、模型列表、真实对话无缝衔接若你在同一账户下还需要语音能力可直接前往语音合成与语音识别页面复用同一凭据构成完整的聊天 语音闭环。【免费下载链接】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),仅供参考
返回列表