JanitorAI 中文教程:国内配置代理五分钟开聊

三步接入,直接照做

JanitorAI 是角色卡平台,自身不带模型,聊天前必须在 API Settings 里接一个大模型端点。国内用户最顺的路径是接 OpenAI 兼容中转,全程三步。 第一步,注册 kkaiapi.com,邮箱验证码即可。进控制台的 API Keys 页面新建一个 Key,复制保存。第二步,打开充值页,支付宝或微信支付,按量计费,没有订阅,充多少用多少。第三步,回到 JanitorAI,进任意角色的聊天页,点右上角的 API Settings,切到 Proxy,把端点、Key、模型 ID 填进去,保存后发一句话测试。 下面把 Proxy 面板的五个字段逐个讲清楚,照抄就能用。

代理面板五个字段逐个讲

五个字段里,URL 是报错重灾区。JanitorAI 不会帮你补全路径,必须填完整端点,格式是固定的:域名 https://api.kkaiapi.com 加上路径 /v1/chat/completions,一个字符都不能少。 三种典型错误写法:只填域名,缺路径;填到 /v1 结尾,JanitorAI 不会自动追加 /chat/completions;结尾多打斜杠或复制进空格。任何一种都会 404 或无响应。照抄下面的配置即可:

API 模式                 : Proxy
Model (Custom)           : deepseek-v4-flash
Other API/proxy URL      : https://api.kkaiapi.com/v1/chat/completions
API Key                  : sk-你的密钥
Custom Prompt            : (留空)

保存后刷新页面,再发一条消息测试

先在终端验证 Key,再贴进面板

JanitorAI 的报错经常只有一句 network error,看不出是 Key 的问题还是 URL 的问题。建议先在终端用 curl 打一次同样的端点,链路通了再回去填面板:

curl https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

返回 JSON 含 "choices" 字段  => 链路正常,问题只剩面板填写
返回 401                     => Key 错误,重新复制
返回 404                     => URL 路径不完整
返回 429                     => 请求过密,等几秒重试

角色扮演选什么模型

社区首选是 DeepSeek V4 系:便宜、响应快、角色一致性稳,长对话不容易忘设定。日常挂机聊天用 deepseek-v4-flash,剧情复杂再升 deepseek-v4-pro。GLM-5 中文语感自然,适合中文角色卡。Kimi K2.6 上下文长,几十轮以上的长线剧情记忆好。Claude Sonnet 4.6 文笔最好,但 Anthropic 内容政策明确禁止露骨内容,只适合普通创作向的角色扮演。grok-4.5 按 token 计费,xAI 公开政策对成人向虚构文本相对宽松。Qwen 系不建议用来做角色扮演。 生成参数建议:temperature 0.85 到 1.0,再高容易崩人设;Max new tokens 300 到 500,够一段完整回复;上下文长度按模型上限放开,DeepSeek 和 Kimi 都撑得住长历史。

429 与 401 报错排查表

报错先看状态码,九成问题落在下面这张表里。改完配置记得刷新页面再试,JanitorAI 有时会缓存旧配置。

各家模型的内容政策,选型前先了解

不同厂商对生成内容的边界不一样,选模型前了解清楚,可以避免聊到一半被拒绝回复。Anthropic 的使用政策明确禁止露骨内容,所以 Claude 系适合文笔向、剧情向的普通创作,不适合作为边界模糊的角色卡的默认模型。xAI 的公开政策对成人向虚构文本相对宽松。国产模型各自遵循平台内容规范,DeepSeek、GLM、Kimi 在创作自由度、角色一致性和长上下文之间的平衡做得不错,这也是角色扮演社区把 DeepSeek V4 系当默认选择的原因。 实践建议:同一张角色卡可以在 kkaiapi 控制台里用同一个 Key 切换不同模型 ID 试聊几轮,哪个模型的回复风格贴合角色设定就用哪个,不需要为换模型重新注册或重新充值。

常见问题