Janitor AI API 网络错误:原因与修复
带有自定义 OpenAI 兼容代理的 Janitor AI API 网络错误几乎总是由以下五个原因之一引起:URL、密钥、模型名称、限制或上下文大小。本文将按最快找到故障的顺序逐一介绍。


更新于
要点
- 先用 curl 测试接口;如果 curl 成功,则故障在于设置而非服务。
- 使用完整的聊天补全 URL、精确的模型 ID uncensored 以及无空格的密钥。
- 429 表示达到限制:每分钟请求过多、同时请求过多或短暂过载。
- 将上下文设置保持在 100,000 token 窗口以下,并进一步降低以节省信用额度。
步骤 0:找出哪一侧出现故障
“网络错误”是一个通用消息。它告诉你应用未收到可用答案,但未说明原因。在随机更改设置之前,请从终端发送相同的请求。如果请求成功,则接口和你的密钥均正常,问题出在 Janitor 发送的内容上。如果请求失败,你可以读取真实的错误代码。
curl -i https://api.unrestrictedaimodels.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello."}],"max_tokens":20}'
查看输出的第一行。200 和 JSON 回复意味着服务正常。其他任何数字指向下面的章节。-i 标志还会显示标头,包括 X-Balance-USD,即你的剩余信用额度。如果你更喜欢点击操作,文档列出了相同的请求格式。
检查你输入的三个字段
在 Janitor AI 的 API 设置中,你选择代理或自定义 API 选项并填写几个字段。菜单名称在不同版本中会有所变化,因此请根据含义匹配而非标签。
| 字段 | 正确值 | 常见错误 |
|---|---|---|
| 代理 / API URL | https://api.unrestrictedaimodels.com/v1/chat/completions | 仅基础 /v1、缺失的 https:// 或尾部空格 |
| API 密钥 | 来自你仪表板的密钥,原样粘贴 | 多余空格、换行符,或在密钥输入框中输入了“Bearer”一词 |
| 模型名称 | uncensored | 输入诸如 gpt-4 或供应商模型之类的名称 |
Janitor 通常希望在代理字段中输入完整的聊天补全接口 URL,而其他应用(如 SillyTavern)仅需要基础 URL。如果字段提示显示以 /chat/completions 结尾的示例,请遵循该示例。基础 URL 为 https://api.unrestrictedaimodels.com/v1,路径会附加到其后。
该模型不是跨供应商的路由器。只有一个模型,其 ID 为 uncensored。任何其他名称都是错误的值。如果你想了解这两个应用在设置上的差异,请阅读 SillyTavern 与 Janitor AI 的比较。
读取状态码
如果 curl 返回了除 200 以外的内容,请使用此表。
| 状态码 | 含义 | 修复方法 |
|---|---|---|
| 401 | 密钥缺失或错误 | 从你的仪表板再次复制密钥。检查尾部是否有空格。 |
| 404 | 路径错误 | 将 URL 与上表中的 URL 逐字符比较 |
| 400 | 请求正文错误 | 通常是请求中的字段错误;检查模型名称和上下文设置 |
| 429 | 已达到限制 | 参见下一节 |
| 连接错误,无状态码 | 主机名拼写错误,或网络被阻止 | 检查拼写;尝试其他网络或关闭 VPN 和广告拦截器 |
失败的请求不会收费,因此在调试时重试不会花费任何费用。如果你在 curl 中得到 200 但 Janitor 仍显示错误,请继续查看上下文和限制部分。
429:速率限制与并发
HTTP 429 在此处有三种形式。正文包含一个错误代码,告诉你具体是哪一种:
rate_limited:每分钟请求数超过允许值。完整密钥允许 300;试用密钥允许 60。concurrency:同时请求过多。完整密钥允许 8;试用密钥允许 2。- 临时过载:带有
Retry-After: 5标头的 429。等待五秒后重试。
角色扮演应用比你想的更容易触发并发限制。快速点击重新生成、在两个标签页中打开聊天,或在手机上运行第二个聊天,每个操作都会发起另一个请求。流式回复会占用其槽位直到完成。在试用密钥上,两个槽位会迅速填满,因此一个卡住的回复加上一次重新生成就足以导致错误。等待几秒,关闭多余标签页,然后重试。
如果每次调用都立即以 429 失败,且你确定没有其他程序在运行,请确保同一密钥未同时用于其他应用、脚本或朋友的设置中。
上下文大小:隐蔽的原因
Janitor 根据角色卡、你的角色设定、聊天历史和记忆笔记构建提示词,上下文大小上限由你设置。此 API 接受提示词加回复共 100,000 token。如果上下文设置高于此值,或者你设置的回复长度导致总数超过窗口,请求可能会失败。
将上下文设置为 16,000 到 32,000 token,将回复长度设置为几百,然后再次测试。更长并不自动意味着更好:模型会看到更多历史记录,但每条消息都会重新发送所有历史记录,且你需要为此付费。
快速计算。使用 20,000 token 的上下文和 300 token 的回复,一条消息的成本为 20,000 x 0.15 / 1,000,000 + 300 x 0.50 / 1,000,000 = $0.003 + $0.00015 = $0.00315。$20 的充值在该大小下可支付约 6,300 条消息。在 8,000 token 的上下文中,同一条消息的成本为 $0.00135,即每美元可支付的消息数量多出一倍以上。请参阅 定价页面 获取费率和奖金信息。
一组安全的初始设置
当你不确定问题所在时,重置为纯配置,确认其正常工作,然后一次只提高一个设置。这样,导致问题的设置就会显现出来。
- 上下文大小: 16,000 token。
- 最大回复长度: 300 到 500 token。
- Temperature: 0.8。高于 1.2 的值会产生奇怪文本,而非网络错误,但它们是常见的混淆来源。
- 流式输出:如果应用有该选项,请同时尝试开启和关闭。某些代理或广告拦截器会破坏事件流,导致开启时失败但关闭时正常。
- 自定义提示词或越狱输入框:测试时请留空。粘贴过长的提示词会占用大量上下文窗口,导致在添加聊天记录前上下文即已耗尽。
记下是哪项更改解决了问题。角色扮演应用在更新或加载新角色卡后,错误往往会重现,因此记录有效的参数值可避免重复整个排查过程。在社区求助时切勿在截图中分享你的密钥,如果确实分享了,请将其替换。
当简短消息获得回复后,将你的真实角色卡和角色设定粘贴回去。如果此时错误再次出现,说明角色卡或记忆笔记的大小超过了所选上下文窗口的限制。
余额、密钥状态及其他检查
如果密钥正确且 URL 无误但请求仍然失败,请检查你的账户。
- 检查额度:
curl https://api.unrestrictedaimodels.com/v1/balance -H "Authorization: Bearer YOUR_KEY"。余额为零意味着需要充值。额度永不过期,未使用的资金将保留。 - 检查试用额度是否已用完。额度为 $0.50,有效期 7 天。
- 在关闭扩展程序的情况下以无痕窗口打开应用。广告拦截器和隐私扩展程序有时会阻止对未知 API 主机的调用。
- 尝试使用不同的设备或网络。学校、工作或酒店网络可能会阻止对未知主机的访问,而使用移动热点可以快速排除此问题。
- 保存失败 curl 调用中的
X-Request-Id请求头。如果你联系支持团队,该 ID 可帮助他们定位具体请求。
支付支持加密货币(TRC20 链上的 USDT、Base 链上的 USDC),最低金额为 $20。如果你尚未创建密钥,在此处创建一个。如需了解使用该模型的聊天设置概览,请参阅 聊天机器人指南。
更多指南
问答
在 Janitor AI 的代理字段中应填入什么 URL?
使用 https://api.unrestrictedaimodels.com/v1/chat/completions. 如果应用仅要求提供 Base URL,请使用 https://api.unrestrictedaimodels.com/v1.
我应该输入哪个模型名称?
模型 ID 为 uncensored。只有一个模型,因此其他名称将导致失败。
curl 测试成功但 Janitor 显示错误,该怎么办?
降低上下文大小,设置合理的回复长度,关闭重复标签页,并在无扩展程序的无痕窗口中重试。然后检查密钥是否包含多余空格。
失败的请求会消耗我的额度吗?
不会。失败或被拒绝的请求不收费。