文档

文档

Janitor AI

Janitor AI 的代理配置需要填写完整的端点 URL,而不是 base URL——路径末尾是 /chat/completions。只要这一项填对,其余只需设置名称、模型 ID 和密钥。

API Settings → Proxy → Add Configuration:Proxy URL 是完整的 /v1/chat/completions 路径,Model Name 必须精确填写目录 ID。

Janitor AI · API Settings
☰ → API Settings → Proxy → + Add Configuration

  Config Name   Kunavo
  Model Name    claude-sonnet-5
  Proxy URL     https://api.kunavo.com/v1/chat/completions
  API Key       sk-kn-...
Proxy URL 是完整的端点 URL。 Janitor AI 自己的指南指出,它必须以 /chat/completions 结尾,因此这里应填写 https://api.kunavo.com/v1/chat/completions——而不是你会粘贴到编程工具中的 base URL。在这里粘贴 base URL,是“代理无法使用”最常见的原因。
Model Name 必须完全准确。 Janitor AI 会原样传递这个字符串,因此拼写错误或使用显示名称,都会导致端点返回错误,而不是 UI 显示有用提示。请从 GET /v1/models 或本网站的 /models 复制 ID。
还没有密钥?创建 Kunavo 账户,创建一个密钥(以 sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Janitor AI 设置页面。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 打开任意聊天,点击顶部的 ☰ 菜单,然后选择 API Settings。
  3. 选择 Proxy,然后点击 + Add Configuration。
  4. 按上文准确填写 Config Name、Model Name、Proxy URL 和 API Key,然后保存。

    Janitor AI 当前的 TL;DR 快速入门代理配置说明列出了相同的字段——Config Name、Model Name、Proxy URL、API Key 和 Custom Prompt。进入这些字段的路径是:齿轮图标、API Settings 和 Add Configuration。说明中提供的 Proxy URL 示例以 /v1/chat/completions 结尾,随后要求点击 Add、Save Settings 并刷新页面(help.janitorai.com,阅读日期:2026 年 10 月 25 日)。

  5. 发送一条消息。收到回复说明代理正常;错误中提到模型,说明是 Model Name 有误;错误中提到 URL,则说明是路径有误。

已于 2026年9月6日对照 Janitor AI 官方代理指南检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON,则相同的基础 URL 和密钥可以在 Janitor AI 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models,包含价格的目录见模型页面。费率单位为每 1M token 的美元,格式为输入 / 输出。

模型 IDKunavo 输入 / 输出它在 Janitor AI 中的位置
claude-sonnet-5$1.40 / $7.00默认选择——适合大多数人的均衡方案
claude-haiku-4-5$0.70 / $3.50每轮成本最低,而且速度快
claude-opus-5$3.50 / $17.50价格较高的那个;在确定前先查看每轮成本
gpt-5-6-terra$0.70 / $4.20适合长对话,此时上下文长度是限制因素
计费方式是从预付余额中按 token 扣费,无月费——参见 计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

常见问题

Janitor AI 需要什么样的 Proxy URL?

需要填写完整的 chat-completions 端点,而不是 base URL。Janitor AI 官方指南指出,URL 必须以 /chat/completions 结尾,并以完整路径为例。因此,对于 OpenAI 兼容服务,URL 应为 https://<host>/v1/chat/completions。代理配置正确却没有响应,最常见的原因就是填入了 base URL。

如何在 Janitor AI 中设置自定义代理?

打开聊天,点击 ☰ 菜单,选择 API Settings,再选择 Proxy,然后点击 + Add Configuration。填写 Config Name、准确的 Model Name、以 /chat/completions 结尾的 Proxy URL,以及 API Key;保存后发送一条测试消息。收到回复即可确认这四项都正确。

为什么 Janitor AI 提示找不到模型?

因为 Model Name 会原样发送到端点,必须与真实模型 ID 完全一致——显示名称、大小写差异和末尾空格都会导致失败。请从 Provider 的模型列表或 GET /v1/models 调用结果中复制 ID,不要凭记忆输入。

在 Janitor AI 中使用代理需要付费吗?

费用取决于代理背后端点的收费标准。Janitor AI 不会对代理使用收费;API Provider 会按 Token 计费,对话发送的每条消息都会产生费用——在较长的角色扮演聊天中,每一轮都会包含完整历史记录。选择更便宜的模型,并使用支持提示缓存的端点,可以降低费用。