Skip to main content
ChatBox 是支持 Windows、macOS、Linux、iOS、Android 和 Web 的开源 AI 客户端。它支持「OpenAI API」类型的自定义服务商,因此可以直接接入 Ace Data Cloud。本文介绍配置流程。

申请流程

要在 ChatBox 中接入 Ace Data Cloud,首先到 Ace Data Cloud 控制台,获取您的 API Token,留作备用。 获取 Ace Data Cloud API Key 如果你尚未登录或注册,会自动跳转到登录页面邀请您来注册和登录,登录注册之后会自动返回当前页面。 在首次申请时会有免费额度赠送,可以免费体验 Ace Data Cloud 的模型服务。

下载 ChatBox

到 ChatBox 官网 按平台下载,或直接使用免安装的 Web 版:
  • 桌面:Windows .exe、macOS .dmg(区分 Intel / Apple Silicon)、Linux AppImage
  • 移动:App Store、Google Play、官网安卓直链

配置 Ace Data Cloud

启动 ChatBox,进入 设置 → 模型 → 添加自定义 Provider,将 API Mode 设为 OpenAI API Compatible,然后填入: ChatBox Ace Data Cloud Provider 配置界面 ChatBox 的请求路径是 {API Host} + {API Path},因此 Host 只填根域名即可: ChatBox 不会自动调用 /v1/models,需要在模型设置页底部的「自定义模型」输入框中手动填写模型 ID(每行一个),保存后即可在对话界面的模型下拉中选择。能力开关、上下文窗口和输出上限必须按所选模型的当前合同填写,不要照抄其他模型的数值。

选择模型

模型目录会持续更新。优先使用客户端自动加载的模型列表;需要手动填写时,先请求 GET https://api.acedata.cloud/v1/models 获取当前模型 ID,再按客户端支持的上下文、图片和工具调用能力选择。

验证对接

如果不确定问题出在 ChatBox 还是网络,可以先用 curl 直接验证端点(把 {token} 替换为你的 Token):
返回 OpenAI 兼容的 chat.completion 对象即说明 Token 与端点都已就绪;若返回 HTTP 403 used_up 则表示 Token 有效但余额不足,到 控制台 充值即可。

常见问题

提示 404 Not Found

通常是 API Host 多加了 /openai 或 /v1。Host 只填 https://api.acedata.cloud,路径交给默认的 /v1/chat/completions。

提示 401 / token_mismatched

请确认「API 密钥」中粘贴的是 Ace Data Cloud 的 Token(不含 Bearer 前缀、无多余空格),且所属应用的余额充足。

模型下拉里看不到模型

ChatBox 不会自动拉取模型列表,必须在「自定义模型」框里手动填写模型 ID 并保存。

想在 ChatBox 里生成图片

Ace Data Cloud 的图像生成是独立的 Images API(/openai/images/generations),与对话接口不同路径,ChatBox 的图像入口无法直接对接。如需画图,请参考 图像生成 API 文档 用 curl / SDK 调用。

了解更多