在 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	备注
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-k3`	推理、视觉、超长上下文

验证对接

如果不确定问题出在 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。

静觅崔庆才的个人站点 - Python爬虫教程