AIRI 接入 Fireworks AI：OpenAI 兼容聊天提供者的配置指南

AIRI 接入 Fireworks AIOpenAI 兼容聊天提供者的配置指南【免费下载链接】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/airiFireworks AI 提供与 OpenAI 格式兼容的聊天 API可以在 AIRI 的意识Consciousness模块中作为聊天提供者直接使用。本文基于仓库文档 docs/content/ko/docs/manual/config/providers/consciousness/fireworks.md完整讲解 API Key 获取、AIRI 内提供者配置、配置验证与模型接入的完整流程并结合 提供者注册源码 剖析其配置结构、校验逻辑与推理参数映射原理。读完本文你将能够在 AIRI 中独立完成 Fireworks AI 的接入与排错。Fireworks AI 与 AIRI 的兼容关系Fireworks AI 是提供托管推理服务的云平台其聊天接口遵循 OpenAI 的消息格式因此被 AIRI 归为OpenAI 兼容OpenAI-compatible提供者。这意味着如果你已经在 Fireworks AI 上管理模型或推理服务可以复用同一套 API 凭据无需额外申请其他平台的密钥AIRI 只需要一个apiKey与一个baseUrl即可建立连接接入成本极低在仓库的提供者注册表中该提供者的 id 为fireworks-ai显示名为Fireworks.ai任务类型tasks为chat即仅作为聊天提供者使用见 fireworks-ai/index.ts。第一步获取 Fireworks AI API Key在使用前你需要先在 Fireworks AI 平台创建 API Key按照 Fireworks AI 官方的 onboarding 指南完成账号开通与初始设置在控制台新建一个 API Key复制该 Key并妥善保存在安全位置如密码管理器。⚠️API Key 安全警告切勿将 API Key 提交到版本库、包含在截图里或分享给任何人。一旦发现密钥泄露应立即在 Fireworks AI 控制台将该 Key 作废并重新生成。第二步在 AIRI 中配置 Fireworks AI 提供者配置入口位于设置 → 提供者Providers→ 聊天Chat→ Fireworks.ai。在该页面完成两项配置配置项必填默认值 / 说明API Key是粘贴第一步获取的密钥输入框以密码形式展示Base URL否默认https://api.fireworks.ai/inference/v1/一般无需修改其中 Base URL 的默认值并非写死在界面上而是由提供者的配置 Schema 定义在 源码 中apiKey为必填字符串baseUrl为可选字符串且通过.default(https://api.fireworks.ai/inference/v1/)提供了默认值。因此你只需粘贴 API Key其余保持默认即可。从实现细节看AIRI 对 Fireworks AI 的接入建立在xsai-ext/providers/create的createFireworks工厂函数之上运行时以createProvider(config)创建客户端实例见 fireworks-ai/index.ts。createProviderConfig则负责把配置字段渲染为设置表单API Key 使用type: password的密码输入Base URL 使用普通文本框两者的标签、描述与占位文案均来自 i18n 本地化配置。第三步验证配置并选择模型完成填写后AIRI 会在你编辑设置的过程中自动校验配置设置有效性校验Validation只要填写了非空 API Key提供者便会进入可校验状态。这在源码中体现为validationRequiredWhen回调——它仅在config.apiKey去除首尾空格后非空时返回true见 fireworks-ai/index.ts。Ping API 按钮如果界面上出现Ping API按钮即可用它发起一次真实请求验证连通性与凭据有效性。校验环节由 OpenAI 兼容提供者通用的校验器createOpenAICompatibleValidators承担Fireworks AI 启用了三项检查见 fireworks-ai/index.tsConnectivity连通性确认能否访问 Base URLModelList模型列表拉取该账号可用的模型列表ChatCompletions聊天补全发送一次最小化的聊天请求确认推理链路可用。模型选择 →校验通过后通过该按钮进入设置 → 模块Modules→ 意识Consciousness在该页面选择 Fireworks AI 作为提供者并挑选具体模型。推理参数reasoning的映射Fireworks AI 提供者声明了聊天推理能力支持enabled/disabled两种模式见 fireworks-ai/index.ts。在运行时这一开关会被映射为 OpenAI 风格的reasoningEffort参数reasoning为enabled时 →reasoningEffort: mediumreasoning为disabled时 →reasoningEffort: none。该映射逻辑位于chat()方法包装层见 fireworks-ai/index.ts也就是说在意识模块中为 Fireworks AI 模型开启推理时实际请求会携带中等推理强度关闭时则不进行推理。问题排查如果 API 校验失败请按以下顺序检查API Key确认粘贴的密钥完整、无多余空格或换行且属于当前账号额度与配额确认账号有可用积分credits或配额未超限请求限制确认未被平台的速率限制rate limit拦截网络连接确认当前设备能够访问https://api.fireworks.ai/inference/v1/没有被网络策略阻断。另外如果 AIRI 拉取不到 Fireworks AI 的模型列表ModelList校验或后续使用时列表为空可以在意识Consciousness页面直接输入 Fireworks AI 提供的精确模型 IDModel ID绕过列表获取步骤完成模型接入。补充说明在仓库的提供者属性表中fireworks-ai被归类为paidCloud付费云服务即按使用量计费的云端推理提供者与本地/自托管提供者区分见 providers/attributes.ts。计费以 Fireworks AI 官方定价为准。本文所有配置均通过 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），仅供参考