文档
Janitor AI
Janitor AI 的代理配置需要填写完整的端点 URL,而不是 base URL——路径末尾是 /chat/completions。只要这一项填对,其余只需设置名称、模型 ID 和密钥。
API Settings → Proxy → Add Configuration:Proxy URL 是完整的 /v1/chat/completions 路径,Model Name 必须精确填写目录 ID。
☰ → 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-.../chat/completions 结尾,因此这里应填写 https://api.kunavo.com/v1/chat/completions——而不是你会粘贴到编程工具中的 base URL。在这里粘贴 base URL,是“代理无法使用”最常见的原因。GET /v1/models 或本网站的 /models 复制 ID。sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Janitor AI 设置页面。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 打开任意聊天,点击顶部的 ☰ 菜单,然后选择 API Settings。
- 选择 Proxy,然后点击 + Add Configuration。
- 按上文准确填写 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 日)。
- 发送一条消息。收到回复说明代理正常;错误中提到模型,说明是 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 的美元,格式为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 它在 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 | 适合长对话,此时上下文长度是限制因素 |
常见问题
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 计费,对话发送的每条消息都会产生费用——在较长的角色扮演聊天中,每一轮都会包含完整历史记录。选择更便宜的模型,并使用支持提示缓存的端点,可以降低费用。