文章总结: 本文介绍如何在Jan开源AI桌面客户端中配置AceDataCloud,实现本地与云端模型共存。核心步骤包括申请APIToken、下载Jan、配置OpenAI兼容端点并添加模型ID。文档提供了推荐模型列表和验证方法,并解答了常见连接问题。可操作建议是确保BaseURL以/v1结尾并手动添加模型。 综合评分: 73 文章分类: 其他
在 Jan 中使用 Ace Data Cloud
进击的Coder
2026年7月18日 20:49 江苏
在小说阅读器读本章
去阅读
Jan 是一款主打「离线优先 + 隐私保护」的开源 AI 桌面客户端。它自带本地推理引擎(基于 llama.cpp,Apple Silicon 上可用 MLX),可以直接在本机运行开源模型;同时通过 Remote Engine 机制支持任意 OpenAI 兼容端点。借助这一能力可以接入 Ace Data Cloud,让本地模型与云端 Claude、GPT、Gemini、Grok、DeepSeek、Kimi、GLM 等 60+ 大模型共存于同一客户端,一份 API Token 即可使用。本文介绍配置流程。
申请流程
要在 Jan 中接入 Ace Data Cloud,首先到 Ace Data Cloud 控制台,或者识别下方二维码:
然后获取您的 API Token,留作备用。
如果你尚未登录或注册,会自动跳转到登录页面邀请您来注册和登录,登录注册之后会自动返回当前页面。
在首次申请时会有免费额度赠送,可以免费体验 Ace Data Cloud 的模型服务。
下载 Jan
到 Jan 官网 按平台下载(Windows、macOS、Linux)。Apple Silicon 机型请下载 arm64 包以获得最佳性能。
配置 Ace Data Cloud
Jan 把模型分为 Local Engine(本机运行)与 Remote Engine(第三方 API)两类。Ace Data Cloud 走 OpenAI 兼容协议,按 Remote Engine 接入。
打开 Jan,进入 Settings → Model Providers,找到 OpenAI 卡片并编辑:
| 字段 | 值 | 说明 |
| — | — | — |
| API Key | 你的 Ace Data Cloud Token | 控制台复制的 Token |
| Base URL | https://api.acedata.cloud/v1 | 必须以 /v1 结尾,结尾不要带斜杠 |
“
Base URL 必须以
/v1结尾是 Jan 官方文档的明确约定。如果不想覆盖原 OpenAI 配置,可以「+ Add Provider」新建一个openai-compatible类型的供应商,填入相同内容。
Jan 不会自动拉取 Ace Data Cloud 的模型列表,需要在同一编辑页下方点 + Add Model,逐个填写模型 ID。添加后模型会出现在左上角下拉中,并带有「Cloud」图标以区分远程 / 本地。
推荐模型
下面这些模型 ID 均已通过 Ace Data Cloud GET /v1/models 与 POST /v1/chat/completions 验证可用:
| 家族 | 模型 ID | 备注 |
| — | — | — |
| GPT | gpt-5 、gpt-5-mini、gpt-4o | OpenAI 旗舰 / 性价比 / 经典多模态 |
| Claude | claude-opus-4-8 、claude-sonnet-4-6 | Anthropic 旗舰 / 均衡 |
| Gemini | gemini-3.1-pro 、gemini-3-flash-preview | Google 多模态 / 快速 |
| Grok | grok-4 | xAI,原生联网 |
| DeepSeek | deepseek-v3 | 高性价比,中文友好 |
| Kimi | kimi-k2.5 | 长文本 |
完整模型清单请以 Ace Data Cloud 服务文档 为准。
验证对接
如果不确定问题出在 Jan 还是网络,可以先用 curl 直接验证端点(把 {token} 替换为你的 Token):
curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-5",
"messages": [{"role": "user", "content": "ping"}]
}'
返回 OpenAI 兼容的 chat.completion 对象即说明 Token 与端点都已就绪;若返回 HTTP 403 used_up 则表示 Token 有效但余额不足,到 控制台 充值即可。
进阶:本地 + 云端混合
Jan 内置一个可开启的本地 OpenAI 兼容 API Server(Settings → Local API Server),开启后监听 http://localhost:1337/v1/chat/completions,运行你下载的本地模型。这样可以在 LangChain / LlamaIndex 等框架里把 Base URL 指向本地做免费调试,复杂任务再切到 Ace Data Cloud 远程模型。切换模型时对话上下文不会丢失。
常见问题
提示 Connection error 或 404
通常是 Base URL 漏了 /v1。改成 https://api.acedata.cloud/v1(必须以 /v1 结尾,且不要写成 .../openai/v1)。
提示 401 Unauthorized
请确认 API Key 中粘贴的是 Ace Data Cloud 的 Token(不含 Bearer 前缀、无多余空格),且所属应用余额充足。
远程模型不出现在下拉中
Jan 不会自动调用 /v1/models,必须手动 + Add Model 添加模型 ID。
能否上传图片让模型分析
可以,但需选择支持视觉的模型,如 gpt-5、gemini-3.1-pro、claude-opus-4-8。
了解更多
- Jan 官网 | Jan GitHub | Jan 文档
- Jan 接入自定义 OpenAI 兼容端点官方文档
- Jan 本地 API Server 官方文档
- Ace Data Cloud OpenAI Chat Completions API 文档
- Ace Data Cloud 服务列表
- Ace Data Cloud 控制台
免责声明:
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景,旨在提升网络安全防护能力,具有明确的技术研究属性。
任何单位或个人未经授权,将本文内容用于攻击、破坏等非法用途的,由此引发的全部法律责任、民事赔偿及连带责任,均由行为人独立承担,本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布,若存在版权侵权或其他异议,请通过邮件联系处理,具体联系方式可点击页面上方的联系我。
本文转载自:进击的Coder 《在 Jan 中使用 Ace Data Cloud》
版权声明
本站仅做备份收录,仅供研究与教学参考之用。
读者将信息用于其他用途的,全部法律及连带责任由读者自行承担,本站不承担任何责任。











评论