在 LibreChat 中使用 Ace Data Cloud
内容提要
本文介绍如何在LibreChat中接入Ace Data Cloud。首先获取API Token，然后通过Docker Compose部署LibreChat，配置librechat.yaml文件，将Ace Data Cloud设为自定义OpenAI兼容端点，指定baseURL为https://api.acedata.cloud/v1，并列出推荐模型如GPT、Claude、Gemini等。最后验证对接，并解决常见问题如404错误、模型列表为空等。
延伸解读
baseURL 路径规则易踩坑
配置时需特别注意 baseURL 的路径规则：必须包含 /v1，否则请求会 404。例如 https://api.acedata.cloud/openai/v1 会因缺少 /v1 而失败，而 https://api.acedata.cloud/v1 或 https://api.acedata.cloud/openai 均可正常使用。建议直接使用官方推荐的 https://api.acedata.cloud/v1，避免因路径错误导致对接失败。
模型列表与 fetch 模式的选择
librechat.yaml 中 models.fetch 参数决定模型列表来源：设为 true 时自动从 /v1/models 获取，但若该接口失败会导致模型下拉为空；设为 false 则使用手动指定的 default 列表。为确保稳定，建议设为 false 并手动列出所需模型，同时注意模型 ID 需与 Ace Data Cloud 文档一致，避免无效模型。
多用户与成本控制技巧
librechat.yaml 支持多端点分组，可将模型分为「旗舰组」和「经济组」；使用 apiKey: "user_provided" 可让每个用户填写自己的 Token，实现用量独立计费。此外，设置 titleModel 为便宜模型（如 gpt-5-mini）可降低自动生成对话标题的成本，而 dropParams 可剔除上游不支持的参数，减少 400 错误。
Q&A
如何在LibreChat中接入Ace Data Cloud？
首先在Ace Data Cloud控制台获取API Token，然后通过Docker Compose部署LibreChat，创建librechat.yaml配置文件，将Ace Data Cloud配置为自定义OpenAI兼容端点，设置baseURL为https://api.acedata.cloud/v1，并填入API Token。最后挂载配置文件并启动容器。
LibreChat接入Ace Data Cloud时，baseURL应该填什么？
baseURL应设置为https://api.acedata.cloud/v1，这样实际请求会发送到https://api.acedata.cloud/v1/chat/completions。如果填成https://api.acedata.cloud/openai/v1或https://api.acedata.cloud会导致404错误。
Ace Data Cloud支持哪些模型？
Ace Data Cloud支持GPT、Claude、Gemini、Grok、DeepSeek、Kimi等60+大模型。推荐模型包括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等。
LibreChat中如何验证Ace Data Cloud对接成功？
可以使用curl命令直接测试端点，发送POST请求到https://api.acedata.cloud/v1/chat/completions，携带API Token和模型参数。如果返回OpenAI兼容的chat.completion对象，说明对接成功；如果返回403 used_up，说明Token有效但余额不足。
LibreChat中看不到Ace Data Cloud端点怎么办？
检查docker-compose.yml中是否正确挂载了librechat.yaml文件，并确保yaml文件缩进正确。如果配置无误，重启容器（docker compose restart api）即可。
LibreChat中模型下拉列表为空怎么解决？
如果设置了fetch: true但自动获取模型失败，可以改为fetch: false并手动在default列表中列出模型ID。
LibreChat中如何配置多个模型分组？
在librechat.yaml中可以配置多个endpoint分组，例如旗舰组和经济组。还可以使用apiKey: "user_provided"让每个用户填写自己的Key，实现用量独立。
