在 LibreChat 中使用 Ace Data Cloud

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-k3"
        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 的路径规则：

baseURL	实际请求	结果
`https://api.acedata.cloud/v1`	`https://api.acedata.cloud/v1/chat/completions`	正确
`https://api.acedata.cloud/openai`	`https://api.acedata.cloud/openai/chat/completions`	也可用
`https://api.acedata.cloud/openai/v1`	`https://api.acedata.cloud/openai/v1/chat/completions`	404（`/openai` 下没有 `/v1`）
`https://api.acedata.cloud`	`https://api.acedata.cloud/chat/completions`	404（缺 `/v1`）

家族	模型 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`	推理、视觉、超长上下文

验证对接

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

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