在 LibreChat 中使用 Ace Data Cloud

进击的Coder

2026年7月13日 22:19
江苏

在小说阅读器读本章

去阅读

LibreChat 是一个高度可配置的开源 AI 客户端，在一个界面里复刻 ChatGPT 的完整体验，并加上多服务商支持与企业级配置。它的特点是用一份 librechat.yaml 配置文件描述所有服务商、模型与路由规则，配置可版本化、可代码评审。它原生支持自定义 OpenAI 兼容端点，因此可以接入 Ace Data Cloud，一份 API Token 同时访问 Claude、GPT、Gemini、Grok、DeepSeek、Kimi、GLM 等 60+ 大模型。本文介绍配置流程。

申请流程

要在 LibreChat 中接入 Ace Data Cloud，首先到 Ace Data Cloud 控制台，或者识别下方二维码：

然后获取您的 API Token，留作备用。

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验 Ace Data Cloud 的模型服务。

部署 LibreChat

LibreChat 通过 Docker Compose 部署，先准备目录并下载官方配置：

mkdir -p ~/librechat && cd ~/librechat
curl -O https://raw.githubusercontent.com/danny-avila/LibreChat/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/danny-avila/LibreChat/main/.env.example
mv .env.example .env

在 .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）：

version: 1.0.5
cache:true

endpoints:
custom:
    -name:\"Ace Data Cloud\"
      apiKey:\"{token}\"
      baseURL:\"https://api.acedata.cloud/v1\"
      models:
        default:
          -\"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-k2.5\"
        fetch:false   # false=用固定列表；true=自动 GET /v1/models
      titleConvo:true
      titleModel:\"gpt-5-mini\"
      modelDisplayLabel:\"Ace Data Cloud\"

在 docker-compose.yml 的 api 服务下把该文件挂进容器，然后 docker compose up -d 启动：

    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml

注意 baseURL 的路径规则：

推荐模型

下面这些模型 ID 均已通过 Ace Data Cloud GET /v1/models 与 POST /v1/chat/completions 验证可用：

完整模型清单请以 Ace Data Cloud 服务文档 为准。

验证对接

如果不确定问题出在 LibreChat 还是网络，可以先用 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 有效但余额不足，到 控制台 充值即可。

进阶：yaml 配置技巧

librechat.yaml 支持多个 endpoint 分组（例如「旗舰组」与「经济组」），可以用 apiKey: \"user_provided\" 让每个用户填自己的 Key、用量各算各的；titleModel: \"gpt-5-mini\" 用便宜模型自动生成对话标题；dropParams 可以统一删掉某个上游不支持的参数以避免 400 错误。详见 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。

了解更多

• LibreChat 官网 ｜ LibreChat GitHub ｜ librechat.yaml 配置详解
• LibreChat 自定义端点（Custom Endpoints）官方文档
• Ace Data Cloud OpenAI Chat Completions API 文档
• Ace Data Cloud 服务列表
• Ace Data Cloud 控制台