使用 AIRI 官方提供商登录、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/airi本篇技术指南讲解如何启用 AIRI 的官方聊天提供商你无需准备任何第三方 API Key只需完成 AIRI 账户登录即可在桌面端与网页版中直接开启聊天并通过 Flux 电量体系计费与充值。读完本文你将掌握官方提供商的完整开通流程登录 → 检查电量 → 充值 → 排查并能从源码层面理解 Flux 余额的初始化、扣减与幂等记账机制。为什么选择官方提供商AIRI 支持大量第三方聊天服务商OpenRouter、DeepSeek、OpenAI 兼容 API、Ollama 等详见 配置聊天模型但如果你希望快速上手、简化配置可以直接选择AIRI 官方提供商零凭据配置不需要创建、复制或保管任何 API Key也不涉及 Base URL、模型 ID 等字段的填写。统一登录态官方服务直接复用你的 AIRI 账户登录状态凭据生命周期由账户体系管理而不是散落在本地设置中。即开即用登录后即可在设置 → 意识中选择官方服务商与模型开始对话。从源码结构看这一特性对应了 provider 配置的认证归属设计在 packages/provider-inference/src/types.ts 中ProviderConfiguredBy类型区分了user用户手动填写凭据与authentication由账户认证自动配置两种生命周期。官方提供商即属于后者——配置由认证流程创建与回收用户无需介入。第一步登录账户在 AIRI 客户端中点击登录按钮此时会打开一个浏览器页面。选择登录方式。目前官方支持三种方式邮箱、Google、GitHub。::: info 中国用户特别提醒 中国用户可能无法使用 Google 和 GitHub 登录请使用邮箱登录。目前暂不支持手机号注册登录。 :::按页面提示完成登录/注册。::: info 如果没有收到登录/验证邮件请先检查是否被归入垃圾邮件文件夹。 :::登录相关的源码细节账户登录后服务端会为当前用户建立 Flux 余额账户。以server/apps/api中的 Flux 服务为例flux.ts查询余额时优先走 Redis 缓存userFluxRedisKey(userId)缓存未命中才回源数据库。若数据库中不存在该用户的user_flux记录服务会在同一个数据库事务内创建余额记录并写入一条type: initial的流水ledger entry避免并发下重复初始化。第二步检查可用电量Flux每个新账户都会获得一定的初始电量当前为150 电量。每次对话会按规则消耗部分电量电量耗尽后暂时无法继续对话需要充值后才能恢复。这里需要说明初始电量数值并非硬编码而是由服务端配置项INITIAL_USER_FLUX决定。在 config-kv/definitions.ts 中可以找到整套 Flux 计费配置项配置项类型默认值含义INITIAL_USER_FLUXnumber0新用户初始化余额文档当前生效值为 150由服务端实际配置FLUX_PER_REQUESTnumber5每次请求的基础电量消耗FLUX_PER_1K_TOKENSnumber1每 1000 token 的额外电量消耗FLUX_PER_1K_CHARS_TTSnumber必填TTS 每 1000 字符的电量消耗TTS_DEBT_TTL_SECONDSnumber86400TTS 尾差欠账的过期时间24 小时STRIPE_FLUX_PRODUCT_IDstring无默认电量包的 Stripe 商品 ID缺失时表示充值暂不可用也就是说单次对话的实际扣费约等于FLUX_PER_REQUEST (本次 token 数 / 1000) × FLUX_PER_1K_TOKENS具体数值由服务端动态配置客户端无需关心。余额查询的服务端接口客户端检查电量时调用的是GET /api/v1/flux接口。在 routes/flux/route.test.ts 的测试中可以确认该接口返回{ userId, flux }即当前用户的电量余额。第三步充值电量目前仅支持在 AIRI 网页版充值具体流程登录 AIRI 网页版。打开设置 → Flux。选择电量包按页面提示完成付款。桌面版暂不支持直接充值当桌面端电量不足时请前往 AIRI 网页版完成充值再回到桌面端继续使用。充值背后的服务端实现充值由 Stripe 支付流程驱动服务端提供完整的电量账本能力。在 billing-service.ts 中可以看到电量扣减debitFlux的核心设计事务一致性在单个数据库事务内完成锁定余额行 → 校验余额 → 更新余额 → 写入流水。幂等防重复扣费流水表上建有(user_id, request_id) WHERE request_id IS NOT NULL的唯一部分索引同一requestId的重试不会二次扣费网络错误、Worker 重启都不会导致重复计费。部分扣减语义当0 余额 请求量时余额会被扣到 0流水记录实际扣费额与requestedAmount、unbilled元数据防止余额不足用户反复重放请求的漏洞。充值对应的creditFlux增加余额与setFlux管理员设为绝对值同样会写入带direction: credit | debit元数据的账本流水每次余额变动均可审计追溯。官方提供商的联动能力使用官方提供商登录后AIRI 的语音能力也可以走官方通道无需任何第三方凭据官方语音合成TTS依赖当前登录态不需要创建或填写第三方 API Key。配置路径为设置 → 服务商 → 语音合成 → AIRI 官方语音合成随后在设置 → 发声中选择模型和音色并试听验证。详见 官方语音合成文档。官方语音识别ASR同样以官方服务商形式提供transcription/official.md。从实现看官方语音的音色来源被明确建模为official_default官方默认与official_selected官方选定等类型见 audio-speech-ws/session.ts 的StreamingTtsVoiceType会话结束时服务端会按实际用量统一计费。排查指南如果官方提供商无法正常工作请按以下顺序排查现象处理方式没有收到登录邮件检查垃圾邮件文件夹确认邮箱地址输入无误网页端无法显示可用电量包稍后重试确认服务端已配置STRIPE_FLUX_PRODUCT_ID未配置时充值入口不可用无法创建付款稍后重试或检查网络与付款渠道桌面端需要充值前往 AIRI 网页版设置 → Flux完成操作官方模型/音色列表加载失败确认账户已登录、网络正常、余额充足服务端未提供流式能力时流式选项不会出现电量耗尽无法对话在网页版充值后恢复余额不足时官方会拒绝请求不会产生额外欠费此外官方服务可用的模型、额度和区域由服务端决定请勿分享账户登录状态或浏览器会话信息避免凭据泄露导致额度被盗用。总结AIRI 官方提供商是绕过第三方 API 配置、快速体验完整 AIRI 能力的捷径登录 → 检查 Flux 余额 → 网页版充值三步即可稳定运行。其背后的 Flux 体系是一套经过事务与幂等设计的记账系统——初始额度、按请求/按 token 扣费、TTS 按字符计费均由服务端配置项控制充值走 Stripe 并全程留痕确保扣费不重复、余额可追溯。对大多数想要直接上手 AIRI 的用户来说这是当前文档consciousness/official.md推荐的首选方案。【免费下载链接】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），仅供参考