在LibreChat中使用AceDataCloud

admin 2026-07-22 07:35:38 网络安全文章 来源:ZONE.CI 全球网 0 阅读模式

文章总结: 本文介绍如何将AceDataCloud作为自定义OpenAI兼容端点集成到LibreChat中,通过一份APIToken访问60+大模型。核心步骤包括申请Token、部署LibreChat、配置librechat.yaml文件并正确设置baseURL。推荐使用https://api.acedata.cloud/v1作为端点,并建议用curl验证对接。可操作建议是确保yaml缩进正确并重启容器以生效。 综合评分: 82 文章分类: 实战经验,安全工具,AI安全


cover_image

在 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_SECRETJWT_REFRESH_SECRETCREDS_KEYCREDS_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 的路径规则:

| 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 均已通过 Ace Data Cloud GET /v1/models 与 POST /v1/chat/completions 验证可用:

| 家族 | 模型 ID | 备注 | | — | — | — | | GPT | gpt-5gpt-5-minigpt-4o | OpenAI 旗舰 / 性价比 / 经典多模态 | | Claude | claude-opus-4-8claude-sonnet-4-6 | Anthropic 旗舰 / 均衡 | | Gemini | gemini-3.1-progemini-3-flash-preview | Google 多模态 / 快速 | | Grok | grok-4 | xAI,原生联网 | | DeepSeek | deepseek-v3 | 高性价比,中文友好 | | Kimi | kimi-k2.5 | 长文本 |

完整模型清单请以 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 控制台

免责声明:

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景,旨在提升网络安全防护能力,具有明确的技术研究属性。

任何单位或个人未经授权,将本文内容用于攻击、破坏等非法用途的,由此引发的全部法律责任、民事赔偿及连带责任,均由行为人独立承担,本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布,若存在版权侵权或其他异议,请通过邮件联系处理,具体联系方式可点击页面上方的联系我

本文转载自:进击的Coder 《在 LibreChat 中使用 Ace Data Cloud》

评论:0   参与:  0