AIRI 官方提供商Official Provider接入指南零配置启用聊天、Flux 余额与充值排查【免费下载链接】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/airiAIRI 官方提供商是项目自带、由官方服务托管的聊天能力入口无需自行申请或填写任何第三方 API Key登录 AIRI 账户即可在“意识Consciousness”模块中启用聊天。本文以 docs/content/zh-Hans/docs/manual/config/providers/consciousness/official.md 为骨架结合仓库中官方提供商的源码实现provider 定义、认证 store、服务端 Flux 路由与桌面端登录流程auth.ts完整覆盖登录、余额、启用、充值与故障排查的全流程。读完本文你将能在 Web 与桌面端快速启用官方聊天能力理解“Auto 模型”“configuredBy: authentication”“Flux 余额”的底层机制并独立解决登录收不到邮件、电量不显示等常见问题。为什么选择官方提供商对于希望快速上手、又不想手动配置第三方服务商密钥的用户官方提供商是最直接的路径零 API Key 配置登录账户即完成提供商“配置”不需要前往 OpenRouter、DeepSeek、Ollama 等第三方页面申请密钥开箱即用的模型路由选择Auto模型后请求由服务端 AI Gateway 自动路由无需关心具体模型 ID与账户体系深度集成身份、余额Flux、计费均由 AIRI 官方服务统一管理且聊天之外的语音合成、实时转写、视觉也提供对应的官方提供商详见下文源码。从源码结构看官方提供商在 packages/stage-ui/src/libs/providers/providers/official/index.ts 中被定义为providerOfficialChat其关键特征包括属性值说明提供商 IDofficial-provider定义于OFFICIAL_CHAT_PROVIDER_ID常量任务类型text-generation仅承担聊天文本生成requiresCredentialsfalse不要求第三方凭据configuredByauthentication配置状态由登录态驱动而非用户填写密钥validationRequiredWhen() false无需额外校验动作模型列表仅auto描述为 “Automatically routed by AI Gateway”其中configuredBy: authentication意味着登录成功后Auth Store 与 Provider Store 会联动把该提供商标记为“已配置”并直接可用登出后default.ts 中的unconfigureAuthenticationProviders()会清空模块选择保证未登录状态下不会误用官方额度。这也解释了为什么“只需登录、无需填 Key”。第一步登录账户Web 端登录在 AIRI 界面点击登录按钮会打开浏览器授权页面目前支持邮箱、Google、GitHub三种登录方式。中国用户特别提醒国内网络环境下 Google 与 GitHub 登录可能不可用请优先使用邮箱登录当前不支持手机号注册与登录。登录完成后OIDC 授权码会被兑换为访问令牌并持久化到localStorage键前缀auth/v1/随后客户端调用会话接口拉取用户信息。这些细节对应 packages/stage-ui/src/stores/auth.ts 中completeSignIn()与fetchSession()的实现前者保存 access/refresh/id token 并调度刷新定时器在 token 生命周期的 80% 时间点提前刷新后者向服务端换取user与session二者同时存在时isAuthenticated才为真。桌面端Electron登录流程桌面端点击登录按钮后走的是系统浏览器 本地回环回调的 OIDC 流程实现位于 apps/stage-tamagotchi/src/main/services/airi/auth.ts主进程生成 PKCE 所需的code_verifier/code_challenge与state并在本地启动一个回环服务器接收回调通过 Electronshell.openExternal()打开系统浏览器访问/api/auth/oauth2/authorize授权端点授权码经由服务端中继页转发给本地回环服务器主进程用授权码兑换 token再通过electronAuthCallback事件通知渲染进程完成登录状态更新。界面入口对应 controls-island-auth-button.vue未登录时显示登录按钮点击后由electronAuthStartLogin触发上述流程登录成功后按钮变为用户头像、昵称与 Flux 余额胶囊。此外引导页onboarding或其他组件若将needsLogin置为true也会自动触发登录。登录邮件收不到怎么办使用邮箱注册/登录时如果长时间未收到验证邮件请检查垃圾邮件Spam文件夹。若仍无邮件可稍后重试或改用其他登录方式。第二步检查可用电量FluxFlux 是 AIRI 官方服务使用的余额credits计量单位官方提供商每次对话都会消耗一定电量余额耗尽后将暂时无法继续对话。注意不同部署环境对新账户的初始赠送电量配置不同不要假设固定数额。请以设置 → Flux页面实际显示的余额为准。余额的读取链路可从源码中确认客户端侧useAuthStore暴露credits与updateCredits()登录状态变为已认证时通过GET /api/v1/flux拉取余额见 packages/stage-ui/src/stores/auth.ts服务端侧GET /api/v1/flux路由受authGuard保护由FluxService.getFlux(userId)返回当前余额见 server/apps/api/src/routes/flux/index.ts数据模型上余额存储在user_flux表每次消费会同步写入flux_transaction流水账见 server/apps/api/drizzle/0001_magenta_skrulls.sql。计费是**事后扣减best-effort**模式聊天请求先通过预检要求余额不低于回退费率避免并发请求透支模型返回后再按 token 用量从 Flux 中扣除余额不足时服务端会返回402 Insufficient flux见 server/apps/api/src/routes/openai/v1/middlewares/billing.ts。这意味着“对话成功但余额下降”是正常现象。第三步启用官方提供商启用步骤非常简短打开设置 → 模块 → 意识Consciousness选择Official Provider作为聊天提供商模型选择Auto返回聊天界面发送一条简短消息如“你好”确认 AIRI 正常回复。这里有两个关键行为需要理解其一“Auto”模型是官方提供商的唯一模型选项。在 official/index.ts 的listModels中官方聊天提供商固定返回一个id: auto、名为Auto的模型项描述为 “Automatically routed by AI Gateway”——模型选择完全交给服务端网关路由客户端无需也无法手动指定具体模型 ID。其二官方提供商只在“没有任何已激活聊天提供商”时才会被自动选择。从 default.ts 中的configureAsDefaultsIfEmpty()可以看到该函数只会在模块当前没有激活提供商或官方选择不完整时把意识/听力/语音/视觉四个模块一键填充为官方默认值。如果你之前手动选择了其他服务商那么即使现在登录了账户之前的提供商选择也不会被替换。需要切换回官方提供商时请手动回到“意识”模块重新选择。模块选择的持久化字段为settings/consciousness/active-provider与settings/consciousness/active-model见 packages/stage-ui/src/stores/modules/consciousness.ts切换到其他提供商时activeModel会被清空需重新选择模型。第四步充值电量Flux余额不足时可通过设置 → Flux页面选择电量包完成充值桌面端AIRI 会在系统浏览器中打开支付页面完成结账应用重新获得焦点focus后会自动刷新余额无需手动刷新购买被禁用的情况某些构建版本或部署环境关闭了购买功能此时不会展示结账入口部署环境限制如果电量包不显示或无法创建支付说明当前部署环境中购买被禁用或暂时不可用。需要留意的是不同客户端对充值入口的支持程度可能因部署与版本而异——以你实际看到的页面为准若桌面端无法直接充值可登录网页版完成操作。支付成功后余额立即写入服务端user_flux表并记录flux_transaction流水客户端在下次拉取余额或应用回归前台时即可看到最新数值。问题排查现象可能原因与处理登录邮件收不到先检查垃圾邮件文件夹若确实未收到稍后重试或更换登录方式Flux 电量包不显示当前部署环境已禁用购买或服务暂时不可用请稍后重试无法创建支付/结账构建或部署禁用了购买功能请确认你所使用的版本支持充值已登录但聊天无响应确认“意识”模块同时选中了Official Provider与Auto模型若此前选过其他提供商登录不会自动替换旧选择需手动切回余额快速下降或提示余额不足计费按 token 用量事后扣减见 billing.ts短时间多条长对话会显著消耗 Flux请前往设置页核对余额延伸官方提供商不止聊天虽然本文聚焦于“意识聊天”模块但从 official/index.ts 的源码可以看出官方提供商家族还覆盖了其他能力面均遵循“configuredBy: authentication 无凭据”的统一模式官方语音合成official-provider-speechHTTP TTS模型与音色目录由服务端/api/v1/audio/models、/api/v1/audio/voices下发并按 UI 语言自动挑选推荐音色官方流式语音official-provider-speech-streaming低延迟双向 WebSocket 合成经/api/v1/audio/speech/ws代理官方实时转写official-provider-transcription流式语音转文字请求指向/api/v1/audio/transcriptions/stream同样只有auto一个模型官方视觉vision-official-provider视觉模块的官方通道。这些提供商的请求都会通过withCredentials()自动附加Authorization: Bearer token头见 shared.ts并附带当前会话 ID 用于分析统计。也就是说一次登录即可打通 AIRI 的“意识—听觉—语音—视觉”整套官方能力配置方式与本文完全一致登录 → 在对应模块选择 Official Provider → 选 Auto → 验证。相关文档聊天模型配置总览见 docs/content/zh-Hans/docs/manual/config/llm.md其他第三方聊天服务商的详细接入指南可在 docs/content/zh-Hans/docs/manual/config/providers/consciousness/ 目录下按需查阅。【免费下载链接】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），仅供参考