文章总结: 本文介绍如何将AceDataCloud作为自定义OpenAI兼容端点集成到LibreChat中,通过一份APIToken访问60+大模型。核心步骤包括申请Token、部署LibreChat、配置librechat.yaml文件并正确设置baseURL。推荐使用https://api.acedata.cloud/v1作为端点,并建议用curl验证对接。可操作建议是确保yaml缩进正确并重启容器以生效。 综合评分: 82 文章分类: 实战经验,安全工具,AI安全
在 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 的路径规则:
| 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-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-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》
版权声明
本站仅做备份收录,仅供研究与教学参考之用。
读者将信息用于其他用途的,全部法律及连带责任由读者自行承担,本站不承担任何责任。









评论