即使 DeepSeek API 密钥本身有效,Janitor AI 仍可能报网络错误:只要端点、模型 ID 和密钥分别来自不同提供商,就会出问题。走直连方案时,请让这三项全部使用同一个 DeepSeek 账号;填入完整的 chat-completions URL,必要时刷新 Janitor AI,再用一条简短消息测试,确认连接正常后再调整生成参数。
先确定接入路线,再创建 API 密钥
Janitor AI 负责聊天界面,DeepSeek 则通过 API 连接提供模型回复。这里的“代理”指的是 LLM 请求的转发路径,并不是 IP 代理或 VPN。想进一步了解两者区别及相关安全取舍,可查看这篇Janitor AI 代理设置指南。
最关键的一条原则很简单:API 密钥、端点和模型名称必须属于同一条提供商路线。例如,将 DeepSeek 密钥与 OpenRouter URL 搭配,即便两者都提供 OpenAI 兼容 API,也不算有效的 DeepSeek 直连配置。
选 DeepSeek 直连、AIReiter,还是 OpenRouter?
| 路线 | 需要创建的密钥 | 端点与模型 | 适合场景 |
|---|---|---|---|
| DeepSeek 直连 | DeepSeek API 密钥 | DeepSeek 端点 + deepseek-v4-flash 或 deepseek-v4-pro | 使用官方计费,提供商链路最短 |
| AIReiter DeepSeek V4 Flash | AIReiter API 密钥 | AIReiter 当前兼容的 API 路线 + deepseek-v4-flash | 需要 AIReiter 托管访问和按量使用模型 |
| OpenRouter | OpenRouter API 密钥 | OpenRouter 端点 + 其当前目录中的模型 ID | 需要在多个模型提供商之间切换 |
本文讲解 DeepSeek 直连方案,因为它最容易依据 DeepSeek 当前 API 文档进行验证。AIReiter 是独立的提供商路线:AIReiter 密钥只能搭配其自身端点使用。如果你想了解 Janitor AI 代理字段更完整的含义,请参阅Janitor AI 代理设置指南。
一则社区反馈说明,单看报错文字并不足以定位问题:
“网络错误” — u/dailylittlebrat,r/JanitorAI_Official
把这句话视为症状,而不是诊断结果。提供商配置混用、过期的模型 ID、余额不足,或配置尚未生效,都可能导致同样的结果。
DeepSeek 直连配置:照着填即可
新建 DeepSeek 直连时,可以先使用以下参数。DeepSeek 当前快速入门文档将 https://api.deepseek.com 列为 OpenAI 兼容基础 URL,并演示了完整的 /chat/completions 请求端点。如果 Janitor AI 会完全按你填写的地址发起请求,请使用完整请求 URL;若你当前使用的连接器说明会自动补全路径,则应按该连接器要求填写基础 URL。
| Janitor AI 字段 | DeepSeek 直连填写值 |
|---|---|
| 配置名称 | DeepSeek Direct |
| 模型名称 | deepseek-v4-flash |
| 代理 URL | 字段要求填写完整端点时,使用 https://api.deepseek.com/chat/completions |
| API 密钥 | 你在 platform.deepseek.com 创建的密钥 |
如果你明确需要更高档的模型,可使用deepseek-v4-pro。DeepSeek 当前的模型与定价页面显示,Flash 的 token 价格低于 Pro,但二者都属于同一 API 系列。DeepSeek 还列出了 deepseek-v4-flash-vision-exp,但 Janitor AI 的纯文本聊天配置应优先从 Flash 或 Pro 开始,而不是使用实验性的视觉模型。
一些旧教程可能会让你填写 deepseek-chat 或 deepseek-reasoner。请以 DeepSeek 实时文档中的当前 V4 ID 为准,不要想当然地认为旧别名依旧可用。
打开 Janitor AI 前需要准备什么
- 一个位于
platform.deepseek.com的 DeepSeek Platform 账号。 - 一枚刚创建的 DeepSeek API 密钥。
- 可用的账户余额。DeepSeek 的错误说明将 HTTP
402对应为余额不足。 - 如果你的 Janitor AI 界面提供这项控制,则需要角色或账号设置允许使用外部代理。
- 配置连接期间可安全保存 API 密钥的位置。
DeepSeek 聊天网站的普通登录账号并不是 API 密钥。请在开发者平台创建密钥,复制时不要带入多余空格;并建议先充值少量余额,以免密钥泄露后产生意外的大额账单。
在 Janitor AI 中配置 DeepSeek,按步骤完成即可
整体流程是:创建密钥,填写端点和模型,保存;必要时刷新页面,最后发送一条简短消息测试。
创建并充值 DeepSeek API 账号
- 打开 DeepSeek Platform。
- 创建开发者账号,或登录已有账号。
- 进入 API 密钥区域,为 Janitor AI 创建一枚密钥。
- 立即复制密钥,并妥善保管,不要泄露。
- 充值足够进行一次小测试的余额。
DeepSeek 的 API 按 token 计费,并非单纯按 Janitor AI 消息条数计费。较长的角色卡和保留较多上下文的聊天记录,可能会在每一轮都发送大量输入 token。因此,与其默认“DeepSeek”代表无限免费 API,不如先以小额余额开始使用更稳妥。
添加代理配置
- 在 Janitor AI 中打开任意角色聊天。
- 寻找 API Settings 或你当前版本中的对应入口。
- 选择可用的 Proxy、Custom 或 OpenAI 兼容提供商选项。
- 如果界面中有 Add Configuration,新建一项配置。
- 将配置名称填写为
DeepSeek Direct。 - 在模型字段粘贴
deepseek-v4-flash。 - 如果代理 URL 字段要求完整端点,粘贴
https://api.deepseek.com/chat/completions。 - 在密钥字段粘贴 DeepSeek API 密钥。
- 保存配置,并将其选为当前启用的路线。
如果 Janitor AI 字段需要最终请求端点,不要只填写 https://api.deepseek.com。但若当前连接器的文档明确说明会自动追加 /chat/completions,则应按其基础 URL 格式填写。
保存、刷新,再做一次简短测试
如果新配置看起来没有生效,先刷新 Janitor AI 页面,或关闭后重新打开标签页,再进行测试。提示词可以尽量简单,例如:“用一句话确认连接正常。”
简短回复只能说明认证、模型解析和基础补全功能正常,不代表所有角色设定或上下文设置都已验证无误。
测试失败时,不要立刻调整 temperature、最大 token 数或其他生成参数。应先检查提供商路线、端点、模型 ID、密钥、余额,以及是否启用了代理使用权限。
按第一个失败环节定位错误
排错最快的方式,是找出最先拒绝请求的系统。先检查 DeepSeek 密钥和余额,再检查 Janitor AI 中填写的字段,最后才考虑浏览器状态或提供商可用性问题。
| 错误或现象 | 最可能的问题层 | 优先处理方式 |
|---|---|---|
401 Unauthorized | 身份验证 | 重新创建或复制一枚新的 DeepSeek 密钥;移除空格,并确认它确实是 DeepSeek 密钥。 |
402 或余额不足 | 账户计费 | 为与该密钥关联的 DeepSeek 账户充值。 |
404 或找不到模型 | 端点或模型 ID | 将完整 URL 和精确模型名称与 DeepSeek 当前文档逐项核对。 |
429 Too Many Requests | 提供商速率限制 | 停止快速重试,等待一段时间,降低请求频率,并查看提供商的限制说明。 |
| 网络错误或“failed to fetch” | URL、浏览器、权限或可达性 | 重新检查完整 HTTPS 端点,刷新 Janitor AI,并确认代理权限设置。 |
500 或 503 | 提供商侧可用性 | 等待后稍晚再试;反复重试可能让速率限制问题更严重。 |
| 回复为空或被截断 | 生成或上下文处理 | 在确认密钥和路线无误后,测试更短的对话,并适度调整输出上限。 |
DeepSeek 官方错误参考明确区分了认证失败(401)、余额问题(402)、速率限制(429)、内部错误(500)和服务器繁忙(503)。这种区分很重要:更换 API 密钥无法解决 429,更换 IP 也无法为出现 402 的账户增加余额。
可以先用 DeepSeek 文档中的快速入门客户端测试同一组提供商参数,以区分是提供商侧故障还是 Janitor AI 配置问题;切勿公开粘贴仍在使用的 API 密钥。
Janitor AI 使用 DeepSeek 常见问题
Janitor AI 能不用 API 密钥接入 DeepSeek 吗?
不能通过直连 API 路线实现。Janitor AI 的自定义代理连接需要你所选提供商路线的凭据;DeepSeek 普通聊天账号不能代替 DeepSeek Platform API 密钥。
在 Janitor AI 中使用 DeepSeek 是免费的吗?
DeepSeek 直连 API 应视为按量计费的 API 服务,而非无限制免费聊天。DeepSeek 的定价页面列出了 token 费率,其错误参考中也包含余额不足响应;OpenRouter 的免费路线则有另外的限制。
VPN 或 IP 代理能解决 429 错误吗?
通常不能。429 表示提供商的请求速率限制,因此等待、降低请求频率、更换 API 路线或检查账户限制,通常比更换 IP 地址更有意义。
确保密钥、端点和模型 ID 都来自同一条提供商路线;然后刷新 Janitor AI,用一条简短消息测试,再去微调生成参数。