静觅 ·

在 Jan 中使用 Ace Data Cloud

💡 原文中文，约2800字，阅读约需7分钟。

📝

内容提要

本文介绍如何在Jan开源AI客户端中接入Ace Data Cloud：先获取API Token，下载Jan，在设置中添加OpenAI兼容的远程引擎，填入Base URL和Token，手动添加模型ID。推荐GPT、Claude、Gemini等模型，并可用curl验证连接。还提及本地与云端混合使用及常见问题解决方法。

🔎

延伸解读

手动添加模型是必要步骤

Jan 不会自动拉取 Ace Data Cloud 的模型列表，必须手动在设置中添加模型 ID。这意味着你需要提前从服务文档中确认要使用的模型 ID，并逐个填入。如果模型未出现在下拉列表中，通常是因为没有手动添加，而非配置错误。

Base URL 的常见错误

配置时 Base URL 必须以 /v1 结尾，且不要写成 .../openai/v1。如果遇到 Connection error 或 404，首先检查 Base URL 是否漏了 /v1。另外，API Key 应直接粘贴 Token，不要包含 Bearer 前缀或多余空格，否则会报 401 Unauthorized。

本地与云端混合使用的价值

Jan 支持本地模型与云端模型共存，并可通过内置的本地 API Server 实现混合使用。在开发调试阶段，可以将 Base URL 指向本地服务器，免费使用本地模型；复杂任务再切换到云端模型。切换时对话上下文不会丢失，这为开发者提供了灵活的测试和生产环境。

❓

Q&A

如何在Jan中配置Ace Data Cloud？

首先在Ace Data Cloud控制台获取API Token，然后下载并安装Jan客户端。打开Jan，进入Settings → Model Providers，编辑OpenAI卡片，将API Key填入你的Token，Base URL设置为https://api.acedata.cloud/v1（必须以/v1结尾）。最后在下方点击+ Add Model，手动添加模型ID即可。

Jan接入Ace Data Cloud时Base URL应该填什么？

Base URL应填写https://api.acedata.cloud/v1，必须以/v1结尾，且结尾不要带斜杠。如果漏掉/v1会导致Connection error或404错误。

Jan接入Ace Data Cloud后为什么模型列表不显示？

Jan不会自动拉取Ace Data Cloud的模型列表，需要手动在Settings → Model Providers的OpenAI编辑页下方点击+ Add Model，逐个填写模型ID。添加后模型会出现在左上角下拉中，并带有Cloud图标。

Ace Data Cloud支持哪些模型？

Ace Data Cloud支持GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM等60+大模型。推荐模型包括gpt-5、gpt-5-mini、gpt-4o、claude-opus-4-8、claude-sonnet-4-6、gemini-3.1-pro、gemini-3-flash-preview、grok-4、deepseek-v3、kimi-k3等。

如何用curl验证Ace Data Cloud的API连接？

使用curl命令向https://api.acedata.cloud/v1/chat/completions发送POST请求，在Authorization头中填入Bearer {token}，请求体包含模型和消息。如果返回OpenAI兼容的chat.completion对象，说明连接成功；若返回HTTP 403 used_up，则表示Token有效但余额不足。

Jan中如何实现本地模型和云端模型混合使用？

Jan内置本地OpenAI兼容API Server，在Settings → Local API Server中开启后，监听http://localhost:1337/v1/chat/completions，可运行本地模型。在LangChain等框架中可将Base URL指向本地进行免费调试，复杂任务再切换到Ace Data Cloud远程模型，切换时对话上下文不会丢失。