如何在 JanitorAI 中使用 AIHubMix 免费模型:代理设置和常见错误

推理时代阅读约 8 分钟
如何在 JanitorAI 中使用 AIHubMix 免费模型:代理设置和常见错误

JanitorAI 可以通过其代理选项与任何兼容 OpenAI 的 API 进行通信,而 AIHubMix 就是其中之一。整个设置只需在一个表单中输入四个值:

名称:       你喜欢的任何名称,例如 AIHubMix MiMo
代理 URL:  https://aihubmix.com/v1/chat/completions
API 密钥:  你的 AIHubMix 密钥
模型:      xiaomi-mimo-v2.6-pro-free

将 自定义提示 留空,按 测试,然后 添加,并刷新页面。就这样。

在 JanitorAI 社区中报告的大多数故障都来自于这四个字段中的一个输入错误,或者是免费套餐比预期更早用完。本文指南将一次性讲解设置,然后涵盖你可能会遇到的每个错误及其解决方法。

开始之前

你需要三样东西:

  1. 一个 AIHubMix 账户和 API 密钥。 注册后,在 AIHubMix API 密钥页面 创建一个密钥。立即将其复制到安全的地方。
  2. 一个允许代理的机器人。 代理仅适用于在角色选择器或开始聊天按钮上显示“允许代理”的机器人,如 社区代理指南 所述。具有可见角色定义的机器人通常允许使用代理。
  3. 一个模型 ID。 从 AIHubMix 免费模型列表 中选择一个,并准确复制其 ID。社区当前最受欢迎的角色扮演模型是 xiaomi-mimo-v2.6-pro-free;本系列中的模型指南比较了各种选项。

在你发送第一条消息之前需要知道的一件事是:新账户总共获得 10 次试用调用,在所有免费模型之间共享。在一次性充值 1 美元或更多后,账户将切换到每日配额(每天 100 次请求,每分钟 10 次,请求总数为 1M 个令牌)。本系列中的限制指南解释了在长时间聊天中这些配额的使用情况。

四个值及常见错误

字段 输入内容 常见错误
名称 任何标签 无,只有你自己使用
代理 URL 完整的聊天完成 URL 仅粘贴基础 URL
API 密钥 你的 AIHubMix 密钥 来自其他提供商的密钥
模型 确切的模型 ID 使用显示名称代替

模型 ID 填写在 模型 字段中。它是小写的,并保留其 -free 后缀。“小米 Mimo V2.6 Pro(免费)”是显示名称,无法使用;xiaomi-mimo-v2.6-pro-free 则可以。

\1

在代理 URL 标签旁边有一个 添加 /chat/completions 按钮。它只会将 /chat/completions 附加到字段中已有的内容。如果你已经粘贴了完整的 URL,请不要点击它,否则路径会重复。如果你粘贴了 https://aihubmix.com/v1,点击一次即可完成。

API 密钥字段上写着“(可选)”。无论如何都要填写:没有密钥,每个请求都会被拒绝。

自定义提示 会覆盖此代理的系统提示,并在代理处于活动状态时在每个请求的顶部发送。AIHubMix 不需要自定义提示,因此可以留空。

在 JanitorAI 中设置

JanitorAI 于 2026 年 7 月 19 日重新设计了其聊天设置,因此旧视频显示的界面不同。以下步骤已根据 2026 年 10 月的当前网页版本进行了检查:

  1. 与允许代理的机器人打开聊天。
  2. 打开右上角的菜单,选择 设置。
  3. 在 提供者 下,选择 代理。
  4. 在 代理配置 下,点击 + 新建。
  5. 在 新配置 表单中,填写 名称、代理 URL、API 密钥 和 模型,使用上述值。将 自定义提示 留空。
  6. 点击 测试。如果设置成功,则不会弹出任何消息;只有在出现问题时才会显示消息。
  7. 点击 添加,然后刷新页面或重新启动聊天。

第 7 步中的刷新是人们最常跳过的步骤。在页面重新加载之前,JanitorAI 可能会继续通过旧设置发送消息。

你可以保存多个配置,例如每个模型一个,这样在一个模型繁忙时切换会很快。要添加备份,打开已保存的配置,点击 复制,然后仅更改模型字段。

第一次聊天的设置

再次打开菜单 → 设置,查看生成控制。根据 Arcanum RPGs 当前面板的指南,其中两个对第一次运行很重要:

  • 上下文大小。 使用外部模型时,滑块最大可达 128,000 个令牌。开始时设置在 16,000 到 32,000 之间。JanitorAI 自己的提示建议如果回复无法生成则降低此值。
  • 最大令牌数。 0 让模型选择回复长度。任何其他数字都是硬性限制,因此较低的值可能会在句子中途截断回复。

按 保存;在你这样做之前,设置不会生效。

上下文大小不仅影响质量。每次回合都会重新发送整个上下文,所有免费模型共享每天 1M 个令牌的池。一旦聊天填满 32,000 个令牌的上下文,该池大约可以覆盖 30 次回复,远低于 100 次请求的上限。本系列中的限制指南将详细说明这些数字。

可选:在 JanitorAI 之外测试你的密钥

如果你对终端感到熟悉,这个请求可以将“我的密钥错误”与“我的 JanitorAI 设置错误”分开。它使用与 AIHubMix 快速入门 文档相同的端点,并消耗一次请求(如果你没有充值,则为你的 10 次试用调用之一)。

export AIHUBMIX_API_KEY="paste-your-key-here"

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "xiaomi-mimo-v2.6-pro-free", "messages": [{"role": "user", "content": "用五个词说你好。"}]}'

如果回复中有文本,说明密钥和模型 ID 没问题,问题出在 JanitorAI 的字段或缺少刷新。

常见错误及其解决方法

“网络错误”或“获取失败”

测试显示“网络错误。请稍后再试!”或聊天显示“发生网络错误,你可能受到速率限制或遇到连接问题:获取失败”。

  • 原因: 请求从未到达 AIHubMix,或者回复未能返回到你的浏览器。尽管措辞如此,“获取失败”指向的是连接问题,而不是配额。通常的原因是 VPN 或代理阻止或错误路由 aihubmix.com;一个过滤请求的浏览器扩展也可能造成同样的问题。在 AIHubMix 自己对本指南的测试中,VPN 是原因。
  • 解决方法: 关闭 VPN,切换到另一个服务器,或确保它允许 aihubmix.com 通过。在 janitorai.com 上暂停广告拦截或隐私扩展。然后再次按测试。

测试显示错误,或机器人从未回复

  • 原因: 代理 URL 不完整(仅基础 URL 或主页),有拼写错误,或在粘贴完整 URL 后点击了添加 /chat/completions 按钮,导致以 /chat/completions 结尾两次。AIHubMix 对错误路径的回复是“请求的 API 端点不存在。”
  • 解决方法: 精确粘贴 https://aihubmix.com/v1/chat/completions,没有尾随空格。

“未找到模型”或模型错误

  • 原因: 模型字段包含显示名称,包含大写字母,或丢失了 -free 后缀。
  • 解决方法: 再次从免费模型列表中复制 ID,并按原样粘贴。

“无效密钥”或身份验证错误

  • 原因: 密钥属于其他服务,被删除,包含多余空格,或字段为空。AIHubMix 对于空密钥返回“未提供密钥”,对错误密钥返回“无效密钥”。
  • 解决方法: 在 AIHubMix 密钥页面上创建一个新的密钥并重新粘贴。

你更改了设置但没有任何变化

  • 原因: JanitorAI 仍在使用之前加载的配置。
  • 解决方法: 刷新页面或重新启动聊天,并检查是否选择了正确的配置。

机器人的“回复”是通知你试用已用完

  • 原因: 10 次试用调用已用完。AIHubMix 继续以通知的形式回复,而不是错误,因此在 JanitorAI 中,它很可能以聊天消息的形式显示。
  • 解决方法: 充值 1 美元或更多一次;账户将切换到免费模型的每日配额。本系列中的充值指南涵盖了步骤。

错误 429

错误 429 有两个常见原因:

  • 你达到了上限。 超过每分钟或每天的限制,API 返回 429,直到下一个分钟或天开始。一些模型的上限低于标准的每天 100 次和每分钟 10 次(例如,qwen3.6-plus-preview-free 允许每天 50 次和每分钟 5 次),而共享的 1M 令牌池在长时间聊天中可能会先用完。
  • 模型繁忙。 某些模型的免费容量有限,AIHubMix 更新日志 警告说,由于这个原因,免费模型可能会出现 429 错误。当许多人同时使用一个流行模型时,这通常是原因。

解决方法: 等待一分钟并重试,减少发送消息的频率,或切换到另一个保存的配置,使用不同的模型。如果每日配额是问题,配额每天重置一次。

提到 model_retired 的 404 错误

  • 原因: 模型已被移除。从 2026 年 9 月 1 日起,退役模型返回明确的 model_retired 404。
  • 解决方法: 从免费列表中选择另一个模型并更新模型字段。

在使用付费模型后,免费模型停止工作

  • 原因: 当账户余额低于 -$1 时,免费模型无法调用,直到账户再次充值。
  • 解决方法: 充值以使余额回升到该线以上。

仍然卡住?

AIHubMix 联系页面 列出了官方 Discord 服务器、支持电子邮件(feedback@aihubmix.com)和状态页面。状态页面跟踪服务,例如聊天完成,而不是单个模型,因此繁忙的模型不会在其中显示。

为了获得快速回复,请包括:

  • 请求时间和你的时区
  • 模型 ID 和端点(代理 URL)
  • HTTP 状态或错误文本,以及如果显示了跟踪 ID
  • 你期望的内容和实际发生的内容

不要包含你的 API 密钥。支持团队不需要它,任何拥有它的人都可以消耗你的配额。

常见问题

在 JanitorAI 中使用 AIHubMix 是免费的吗?
每个新账户在所有免费模型中获得 10 次试用调用。在一次性充值 1 美元或更多后,免费模型切换到每日配额:每天 100 次请求,每分钟 10 次请求,以及每天共享的 1M 个令牌。

代理 URL 字段中到底应该填什么?
https://aihubmix.com/v1/chat/completions,完整地址。如果你只粘贴了 https://aihubmix.com/v1,请点击一次添加 /chat/completions 按钮以完成。

为什么我在某些机器人中看不到代理选项?
只有标记为“允许代理”的机器人才能使用代理。其他机器人将使用 JanitorAI 自己的模型。

我应该从哪个模型 ID 开始?
从免费模型列表中复制的任何 ID 都可以使用。如果准确复制,许多 JanitorAI 用户从 xiaomi-mimo-v2.6-pro-free 开始;本系列中的模型指南比较了替代选项。

更改模型后我需要刷新吗?
是的。保存配置后,刷新页面或重新启动聊天,以便 JanitorAI 识别更改。

为什么我总是收到 429 错误?
要么你超过了每分钟或每天的上限,要么模型繁忙。等待一分钟,减慢速度,或切换到另一个保存的配置,使用不同的模型。

我可以与朋友分享我的 API 密钥吗?
不可以。服务条款禁止共享 AIHubMix 账户,任何使用你的密钥的人都会消耗你的每日配额。

继续阅读:AIHubMix for JanitorAI 系列

来源