Skip to main content
LibreChat 是高度可配置的开源 AI 客户端,可用 librechat.yaml 描述服务商、模型与路由规则。它支持自定义 OpenAI 兼容端点,因此可以接入 Ace Data Cloud。本文介绍配置流程。

申请流程

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

部署 LibreChat

LibreChat 通过 Docker Compose 部署,先准备目录并下载官方配置:
在 .env 中用 openssl rand -hex 32 生成 JWT_SECRET、JWT_REFRESH_SECRET、CREDS_KEY、CREDS_IV 等安全密钥,并按需设置 ALLOW_REGISTRATION。

配置 Ace Data Cloud

创建 librechat.yaml,把 Ace Data Cloud 作为自定义 OpenAI 兼容端点(完整字段说明见官方 Custom Endpoints 文档,把 {token} 替换为你的 Token):
在 docker-compose.yml 的 api 服务下把该文件挂进容器,然后 docker compose up -d 启动:
注意 baseURL 的路径规则:

选择模型

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

验证对接

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

进阶:yaml 配置技巧

librechat.yaml 支持多个 endpoint 分组,可以用 apiKey: "user_provided" 让每个用户填写自己的 Key;titleModel 指定生成对话标题的模型;dropParams 可以统一删除目标 API 不支持的参数。详见 librechat.yaml 配置详解。

常见问题

启动后看不到 Ace Data Cloud 端点

通常是 yaml 没挂进容器或缩进错误。检查 docker-compose.yml 的 volumes,并校验 yaml 缩进。

提示 404

baseURL 写成了 .../openai/v1 或漏了 /v1。改成 https://api.acedata.cloud/v1。

模型下拉为空

fetch: true 但 /v1/models 失败时,改为 fetch: false 并手动列出 default。

改 yaml 后不生效

需重启容器:docker compose restart api。

了解更多