阅读,与值得关注的内容Readance

在 Jan 中使用 Ace Data Cloud

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 控制台

前往微信阅读全文

内容来自公众号,可前往微信查看原文。

查看作者的更多文章 →