在 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 控制台
版权声明
本站仅做备份收录,仅供研究与教学参考之用。
读者将信息用于其他用途的,全部法律及连带责任由读者自行承担,本站不承担任何责任。











评论