在 AIRI 中配置 302.AI 聚合 API从获取 API Key 到接入 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/airi302.AI 是一个 API 聚合服务商通过一个 API Key 即可调用多种 LLM 模型。本文以 AIRI 项目中的官方配置文档为主线结合仓库内的 provider 实现源码完整讲解如何获取 302.AI 的 API Key、在 AIRI 的Settings → Providers → Chat中完成接入与自动校验并将其模型挂载到Settings → Modules → Consciousness意识模块作为角色的大模型大脑最后给出常见连接故障的排查路径。读完本文你将掌握在 AIRI 中配置 OpenAI 兼容聚合服务商的标准流程、自动验证机制Ping API / 模型列表 / Chat Completions的底层原理以及当校验失败或模型列表加载不出来时的处理方法。为什么选择 302.AI聚合 API 的适用场景302.AI 属于 API 聚合提供商API aggregation provider核心价值在于一把 Key 测多模型它把多家上游模型厂商的接口聚合到统一的 OpenAI 兼容端点配置完成后即可在 AIRI 的Settings → Modules → Consciousness下选择任意 302.AI 上架的 chat 模型。如果你主要在中国大陆网络环境下使用 AIRI可以先尝试 302.AI。官方文档同时提醒实际可用性仍取决于你的网络环境、支付方式与服务商政策。在 AIRI 的 provider 目录体系中302.AI 被归类为付费云服务paid cloud。这一点可以在 attributes.ts 中看到302-ai: paidCloud即{ pricing: paid, deployment: cloud }因此在设置界面的 provider 来源筛选器中会出现在付费 / 云端分类下。获取 API Key打开 302.AI Consolehttps://302.ai/登录或注册账号。在控制台中创建 API Key。复制 Key 并妥善保存。⚠️API Key 安全不要把 API Key 提交到代码仓库、截图分享或泄露给任何人。一旦 Key 疑似泄露应立即在 302.AI 控制台吊销并重新生成。在 AIRI 中配置 302.AI Provider配置入口为Settings → Providers → Chat → 302.AI只需两项配置配置项取值说明API Key你在 302.AI 控制台创建的 Key必填Base URLhttps://api.302.ai/v1/保持默认即可配置项的源码视角从源码看302.AI provider 的配置结构由 zod schema 定义302-ai/index.tsconst ai302ConfigSchema z.object({ apiKey: z.string(API Key), baseUrl: z .string(Base URL) .optional() .default(https://api.302.ai/v1/), })apiKey为必填字符串在设置表单中渲染为密码框type: passwordbaseUrl可留空默认值即官方文档中的https://api.302.ai/v1/。provider 定义通过defineProvider注册到全局注册表registry.ts注册信息包括export const provider302AI defineProviderAI302Config({ id: 302-ai, order: 7, name: 302.AI, tasks: [chat], icon: i-lobe-icons:ai302, ... })tasks: [chat]表明它作为 chat 类 provider 提供能力。真正发起请求时createProvider会把配置合并为三种 provider 能力302-ai/index.tscreateProvider(config) { return merge( createChatProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createEmbedProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createModelProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), ) }也就是说302.AI 除了 chat 对话还同时具备 Embedding向量嵌入与模型列表查询能力——这三者共用同一份 API Key 与 Base URL。验证配置AIRI 如何自动检查 302.AIAIRI 会在你编辑配置时自动触发校验。302.AI 走的是 OpenAI 兼容验证器createOpenAICompatibleValidators并为它启用了两类检查302-ai/index.tsvalidationRequiredWhen(config) { return !!config.apiKey?.trim() }, validators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },validationRequiredWhen表示只要填入了非空 API Key 就进入可验证状态。验证器实现在 validators/openai-compatible.ts具体包含配置合法性检查check-configapiKey不能为空baseUrl必须存在且是合法的绝对 URL否则提示 Base URL is invalid. It must be an absolute URL.。连通性检查check-connectivity对${baseUrl}/models发起带 10 秒超时AbortControllersetTimeout(…, 10_000)的 GET 请求携带Authorization: Bearer apiKey头HTTP 5xx 或网络错误即判定失败。Chat Completions 检查check-chat-completions先拉取模型列表挑一个可用于验证的模型然后用generateText发送内容为ping的探测请求openai-compatible.tsawait generateText({ apiKey: config.apiKey, baseURL: config.baseUrl!, model: normalizedModel, messages: message.messages(message.user(ping)), ...(options?.chatCompletionTokenParameter max_completion_tokens ? { max_completion_tokens: 16 } : { max_tokens: 16 }), })探测请求显式设置max_tokens: 16这是为了兼容部分 OpenAI 兼容服务商不接受低于 16 的输出上限。该检查带缓存与互斥锁Mutex同一轮校验内重复的 chat 探测只会执行一次。 4.模型列表检查check-model-list调用listModels拉取 302.AI 的模型列表若列表为空则报 no models found。这些检查在 UI 上对应着Ping API按钮与各检查项的实时状态。当校验通过后provider 定义中的ProviderValidationCheck枚举types.ts对应的检查结果会逐项呈现——连通性、模型列表、Chat Completions 全部 green 即可继续选择模型。选择模型接入 Consciousness意识模块验证成功后点击Select Model →按钮会跳转到Settings → Modules → Consciousness页面选择 provider302.AI和具体模型。Consciousness 模块承担角色的人格与所选模型职责其界面文案定义在 i18n settings.yaml 中关键交互包括模型下拉搜索按关键词搜索模型Search models...显示Found {count} of {total} models支持展开/收起全部模型手动输入模型名当 provider 不支持模型列表、或列表加载失败时可切换到Model Name输入框直接填入 302.AI 提供的精确模型 IDEnter the model name to use with this providerThinking 选项部分模型支持 Thinking推理模式的开关未配置提示若没有任何 provider页面会显示 No Providers Configured引导你先回到 Providers 设置页完成 LLM provider 的配置。故障排查如果 API 检查失败请按顺序排查API Key 是否正确确认 Key 完整、无多余空格且未过期/被吊销账户余额是否充足302.AI 为付费云服务pricing: paid欠费会导致鉴权或请求失败网络连接是否可达确认你的网络环境能访问https://api.302.ai/结合连通性检查对/models端点的 10 秒超时探测网络不通会直接报网络错误模型列表加载失败如果 AIRI 无法从 302.AI 拉取模型列表可绕开列表查询直接在Consciousness页面手动输入 302.AI 提供的精确模型 ID对应 i18n 中的manual_model_placeholder: Enter the model name to use with this provider。注意确保模型 ID 拼写与 302.AI 控制台 / 官方模型文档完全一致。小结302.AI 是 AIRI 在中国大陆网络环境下快速上手多模型的一个务实选择。整个接入流程可以归纳为三步控制台获取 Key → Settings → Providers 填入 Key 并保持默认 Base URL → 验证通过后在 Consciousness 模块选择模型。AIRI 的 OpenAI 兼容验证器会以/models连通性探测、模型列表拉取和ping对话探测三层检查替你确认配置有效性即使模型列表接口异常手动输入模型 ID 也能让 302.AI 正常工作。【免费下载链接】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 中配置 302.AI 聚合 API：从获取 API Key 到接入 Consciousness 的完整指南
在 AIRI 中配置 302.AI 聚合 API从获取 API Key 到接入 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/airi302.AI 是一个 API 聚合服务商通过一个 API Key 即可调用多种 LLM 模型。本文以 AIRI 项目中的官方配置文档为主线结合仓库内的 provider 实现源码完整讲解如何获取 302.AI 的 API Key、在 AIRI 的Settings → Providers → Chat中完成接入与自动校验并将其模型挂载到Settings → Modules → Consciousness意识模块作为角色的大模型大脑最后给出常见连接故障的排查路径。读完本文你将掌握在 AIRI 中配置 OpenAI 兼容聚合服务商的标准流程、自动验证机制Ping API / 模型列表 / Chat Completions的底层原理以及当校验失败或模型列表加载不出来时的处理方法。为什么选择 302.AI聚合 API 的适用场景302.AI 属于 API 聚合提供商API aggregation provider核心价值在于一把 Key 测多模型它把多家上游模型厂商的接口聚合到统一的 OpenAI 兼容端点配置完成后即可在 AIRI 的Settings → Modules → Consciousness下选择任意 302.AI 上架的 chat 模型。如果你主要在中国大陆网络环境下使用 AIRI可以先尝试 302.AI。官方文档同时提醒实际可用性仍取决于你的网络环境、支付方式与服务商政策。在 AIRI 的 provider 目录体系中302.AI 被归类为付费云服务paid cloud。这一点可以在 attributes.ts 中看到302-ai: paidCloud即{ pricing: paid, deployment: cloud }因此在设置界面的 provider 来源筛选器中会出现在付费 / 云端分类下。获取 API Key打开 302.AI Consolehttps://302.ai/登录或注册账号。在控制台中创建 API Key。复制 Key 并妥善保存。⚠️API Key 安全不要把 API Key 提交到代码仓库、截图分享或泄露给任何人。一旦 Key 疑似泄露应立即在 302.AI 控制台吊销并重新生成。在 AIRI 中配置 302.AI Provider配置入口为Settings → Providers → Chat → 302.AI只需两项配置配置项取值说明API Key你在 302.AI 控制台创建的 Key必填Base URLhttps://api.302.ai/v1/保持默认即可配置项的源码视角从源码看302.AI provider 的配置结构由 zod schema 定义302-ai/index.tsconst ai302ConfigSchema z.object({ apiKey: z.string(API Key), baseUrl: z .string(Base URL) .optional() .default(https://api.302.ai/v1/), })apiKey为必填字符串在设置表单中渲染为密码框type: passwordbaseUrl可留空默认值即官方文档中的https://api.302.ai/v1/。provider 定义通过defineProvider注册到全局注册表registry.ts注册信息包括export const provider302AI defineProviderAI302Config({ id: 302-ai, order: 7, name: 302.AI, tasks: [chat], icon: i-lobe-icons:ai302, ... })tasks: [chat]表明它作为 chat 类 provider 提供能力。真正发起请求时createProvider会把配置合并为三种 provider 能力302-ai/index.tscreateProvider(config) { return merge( createChatProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createEmbedProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), createModelProvider({ apiKey: config.apiKey, baseURL: config.baseUrl! }), ) }也就是说302.AI 除了 chat 对话还同时具备 Embedding向量嵌入与模型列表查询能力——这三者共用同一份 API Key 与 Base URL。验证配置AIRI 如何自动检查 302.AIAIRI 会在你编辑配置时自动触发校验。302.AI 走的是 OpenAI 兼容验证器createOpenAICompatibleValidators并为它启用了两类检查302-ai/index.tsvalidationRequiredWhen(config) { return !!config.apiKey?.trim() }, validators: { ...createOpenAICompatibleValidators({ checks: [ProviderValidationCheck.ModelList, ProviderValidationCheck.ChatCompletions], }), },validationRequiredWhen表示只要填入了非空 API Key 就进入可验证状态。验证器实现在 validators/openai-compatible.ts具体包含配置合法性检查check-configapiKey不能为空baseUrl必须存在且是合法的绝对 URL否则提示 Base URL is invalid. It must be an absolute URL.。连通性检查check-connectivity对${baseUrl}/models发起带 10 秒超时AbortControllersetTimeout(…, 10_000)的 GET 请求携带Authorization: Bearer apiKey头HTTP 5xx 或网络错误即判定失败。Chat Completions 检查check-chat-completions先拉取模型列表挑一个可用于验证的模型然后用generateText发送内容为ping的探测请求openai-compatible.tsawait generateText({ apiKey: config.apiKey, baseURL: config.baseUrl!, model: normalizedModel, messages: message.messages(message.user(ping)), ...(options?.chatCompletionTokenParameter max_completion_tokens ? { max_completion_tokens: 16 } : { max_tokens: 16 }), })探测请求显式设置max_tokens: 16这是为了兼容部分 OpenAI 兼容服务商不接受低于 16 的输出上限。该检查带缓存与互斥锁Mutex同一轮校验内重复的 chat 探测只会执行一次。 4.模型列表检查check-model-list调用listModels拉取 302.AI 的模型列表若列表为空则报 no models found。这些检查在 UI 上对应着Ping API按钮与各检查项的实时状态。当校验通过后provider 定义中的ProviderValidationCheck枚举types.ts对应的检查结果会逐项呈现——连通性、模型列表、Chat Completions 全部 green 即可继续选择模型。选择模型接入 Consciousness意识模块验证成功后点击Select Model →按钮会跳转到Settings → Modules → Consciousness页面选择 provider302.AI和具体模型。Consciousness 模块承担角色的人格与所选模型职责其界面文案定义在 i18n settings.yaml 中关键交互包括模型下拉搜索按关键词搜索模型Search models...显示Found {count} of {total} models支持展开/收起全部模型手动输入模型名当 provider 不支持模型列表、或列表加载失败时可切换到Model Name输入框直接填入 302.AI 提供的精确模型 IDEnter the model name to use with this providerThinking 选项部分模型支持 Thinking推理模式的开关未配置提示若没有任何 provider页面会显示 No Providers Configured引导你先回到 Providers 设置页完成 LLM provider 的配置。故障排查如果 API 检查失败请按顺序排查API Key 是否正确确认 Key 完整、无多余空格且未过期/被吊销账户余额是否充足302.AI 为付费云服务pricing: paid欠费会导致鉴权或请求失败网络连接是否可达确认你的网络环境能访问https://api.302.ai/结合连通性检查对/models端点的 10 秒超时探测网络不通会直接报网络错误模型列表加载失败如果 AIRI 无法从 302.AI 拉取模型列表可绕开列表查询直接在Consciousness页面手动输入 302.AI 提供的精确模型 ID对应 i18n 中的manual_model_placeholder: Enter the model name to use with this provider。注意确保模型 ID 拼写与 302.AI 控制台 / 官方模型文档完全一致。小结302.AI 是 AIRI 在中国大陆网络环境下快速上手多模型的一个务实选择。整个接入流程可以归纳为三步控制台获取 Key → Settings → Providers 填入 Key 并保持默认 Base URL → 验证通过后在 Consciousness 模块选择模型。AIRI 的 OpenAI 兼容验证器会以/models连通性探测、模型列表拉取和ping对话探测三层检查替你确认配置有效性即使模型列表接口异常手动输入模型 ID 也能让 302.AI 正常工作。【免费下载链接】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），仅供参考