中文 ▾
获取 API 密钥

如何在 Janitor AI 中使用 OpenRouter:代理设置

以下是如何在 Janitor AI 中使用 OpenRouter 的方法,以及如何以相同方式替换为其他 OpenAI 兼容的端点。Janitor AI 允许你将聊天指向外部代理,因此任何支持 OpenAI 聊天补全格式的服务都可以提供回复。

聊天气泡通过代理中继连接到 API 服务器塔楼的插图

更新于

要点

  • Janitor AI 的 API 设置接受代理 URL、密钥和模型名称,这正是 OpenAI 兼容服务所需的全部配置。
  • 对于此 API,请使用 https://api.openrouternsfw.com/v1, 你的密钥,以及模型名称 uncensored。
  • 某些版本需要完整的聊天补全 URL;请使用 curl 测试,以确定哪种形式有效。
  • 包含长历史记录的角色扮演消息成本约为 $0.00135,即每 1,000 条消息约 $1.35。

无需绑卡。注册后,一键领取 $0.50 免费试用额度(每人限领一次)。

获取 API 密钥

连接工作原理

Janitor AI 是一个角色聊天网站。除了内置选项外,它还允许你通过 API 设置接入自己的模型。该设置需要三项内容:端点 URL、密钥和模型名称。OpenRouter 符合要求,因为它提供 OpenAI 兼容的端点;其模型名称格式为 vendor/model,密钥来自你的 OpenRouter 账户。

相同的三个字段适用于任何其他 OpenAI 兼容服务。此网站的 API 就是一个例子:基础 URL https://api.openrouternsfw.com/v1,Bearer 密钥,以及模型 ID uncensored。因此,以下步骤涵盖两种情况。如果某一步骤在两者间有所不同,我会特别说明。

Janitor AI 是一个第三方网站,其菜单会发生变化。我描述的是常见的设置布局,因此标签可能略有不同。这些配置值才是关键。

准备好三个值

在打开 Janitor AI 之前,收集以下信息。

字段OpenRouter此 API
接口OpenRouter 文档中的 OpenAI 风格 URLhttps://api.openrouternsfw.com/v1/chat/completions
键来自你 OpenRouter 账户的密钥来自 API 密钥页面 的密钥
模型名称来自其列表的 vendor/model IDuncensored

对于此 API,密钥页面还允许新用户一键领取 $0.50 试用额度,每人限领一次,有效期 7 天。注册支持使用 Google 或电子邮件和密码。在添加余额之前,试用额度足以测试整个设置。

首先使用 curl 测试接口

当代理失败时,Janitor AI 提供的反馈很少;你通常会在聊天中看到通用错误。请在网站外检查接口,以确保在粘贴值之前数值正确。

curl https://api.openrouternsfw.com/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship mechanic."},
      {"role": "user", "content": "Mara, the engine is making that noise again."}
    ],
    "max_tokens": 200
  }'

带有 choices 数组的 JSON 回复意味着密钥、URL 和模型名称均正确。如果你想查看更多,请查看响应标头:X-Balance-USD 显示剩余额度,X-Request-Id 在联系支持时很有用。

在 Janitor AI 中输入代理

  1. 打开与任何角色的聊天。
  2. 在聊天中打开菜单,选择 API 或生成设置。具体名称因版本而异。
  3. 选择代理选项,即自定义 OpenAI 兼容接口的选项,而不是内置模型。
  4. 将接口 URL 粘贴到代理 URL 字段中。
  5. 将密钥粘贴到密钥字段中。
  6. 准确输入提供的模型名称:对于此 API 为 uncensored。
  7. 保存设置并重新加载聊天页面。

使用哪种 URL 格式是人们常卡住的地方。Janitor AI 的代理字段通常期望完整的聊天补全 URL,以 /chat/completions 结尾。其他工具仅期望以 /v1 结尾的基础 URL,并自行添加路径。如果完整 URL 报错,请尝试基础 URL,反之亦然。上面的 curl 测试表明完整 URL 本身是有效的,因此失败指向网站构建请求的方式,而非密钥问题。

模型名称区分大小写,必须匹配。错误的模型名称是导致第一条消息失败的第二个最常见原因。

对角色扮演至关重要的设置

Janitor AI 在代理字段旁边提供了一些生成设置。API 会传递采样参数,因此它们会生效。

  • Temperature: 0.7 到 1.0 保持对话生动。更高的值会导致逐渐偏离主题,并编造与角色卡矛盾的细节。
  • Max tokens: 控制回复长度。300 到 600 的值适合聊天。补全可以使用剩余的 100,000-token 窗口,但聊天回复那么长通常不是你想要的。
  • 上下文大小: API 最多支持 100,000 个 token,包含提示词和补全。使用较小的值(如 8,000)可以在保持每条消息成本较低的同时,保留大量历史记录。仅在角色忘记你需要的内容时再提高该值。
  • 重复控制: 如果角色循环使用相同的短语,适度的频率或存在惩罚会有所帮助。两者都会传递。

该模型经过调整,在合法成人使用时回答时不会触发内容拒绝,因此为成人故事编写的角色卡不应触发拒绝文本。有一条规则是固定的:不允许涉及未成年人的性内容,你不应编写暗示此类内容的角色卡文本。

费用说明

价格为每 1M 输入 token $0.15,每 1M 输出 token $0.50。在角色扮演中,几乎所有成本都来自输入,因为每条消息都会重新发送角色卡和聊天历史。

取一条包含 8,000 个 token 上下文和 300 个 token 回复的消息:

  • 输入:8,000 x $0.15 / 1M = $0.0012
  • 输出:300 x $0.50 / 1M = $0.00015
  • 总计:每条消息 $0.00135,或每 1,000 条消息 $1.35

$20 充值可支付约 14,800 条消息(在该上下文大小下)($20 / $0.00135 等于 14,814)。$0.50 试用额度可覆盖约 370 条。如果将上下文提升至 30,000 token,仅输入成本就会升至 $0.0045,且相同回复下每条消息成本为 $0.00465,因此仅在需要时使用大上下文。

充值从 $20 到 $500 不等,$50 起享 5% 奖励,$100 起享 10% 奖励,$200 起享 15% 奖励。支付方式为加密货币(TRC20 上的 USDT 或 Base 上的 USDC),预付额度永不过期,失败或被拒绝的请求不收费。详细信息见 定价页面。

故障排除

网络错误或无回复

检查 URL 形式(完整路径或基础 URL)。检查密钥字段中是否有尾随空格。然后从你的机器再次运行 curl 测试。

HTTP 401

密钥错误或粘贴时带有额外字符。从密钥页面重新生成。

HTTP 429

阅读错误代码。rate_limited 表示超过每分钟允许的请求数(完整密钥为 300,试用密钥为 60)。concurrency 表示同时过多(完整密钥为 8,试用密钥为 2);在 Janitor AI 中,当你在前一个回复仍在流式输出时重新生成回复时会发生这种情况,因为流式请求会占用其槽位直到结束。带有 Retry-After: 5 的 429 表示暂时过载,因此等待五秒后重试。

回复被截断或冗长

调整 max tokens 和 temperature。如果角色忘记了最近的事件,稍微提高上下文大小。

余额耗尽

X-Balance-USD 头信息显示剩余金额。从仪表板充值;文档详细说明了错误格式。

OpenRouter 或此 API 用于 Janitor AI

它们是不同的服务类型。OpenRouter 是一个路由器,提供来自许多提供商的许多模型;你通过名称选择模型,每个模型能写或不能写什么取决于该模型。在其网站上查看其当前模型列表和定价。此 API 提供单个开放权重文本模型,由独立提供商运行,并针对合法成人使用无内容拒绝进行优化。它不是任何模型制造商的官方 API。

如果你想要多样性,请保留你的 OpenRouter 设置。如果你的角色遇到拒绝,并且你想要稳定、便宜、单一的模型,这个模型易于尝试:注册,领取试用额度,并粘贴上述三个值。提示词不用于训练。

问答

我应该在 Janitor AI 的代理字段中输入什么?

接口 URL、API 密钥和模型名称。对于此 API,分别是 https://api.openrouternsfw.com/v1/chat/completions、你的 API 密钥和 uncensored。如果失败,请尝试以 /v1 结尾的基础 URL。

这与 OpenRouter 相同吗?

不是。OpenRouter 在多个模型和提供商之间路由。这是一个来自独立提供商的开放权重模型,拥有自己的密钥和预付额度。

为什么我会收到 429 错误?

要么你触发了每分钟速率限制,要么同时运行的请求过多,要么服务暂时过载。错误代码和 Retry-After 标头会告诉你具体原因。

我可以先测试再付费吗?

可以。新用户注册后可一键领取 $0.50 的免费试用额度。有效期为 7 天,每人限领一次。

我的聊天记录会被用于训练吗?

否。发送到此 API 的提示词不用于训练。

你只需填写一个表单即可获得密钥

创建账户,复制密钥,更改基础 URL。这就是全部设置。

获取 API 密钥