在 AnythingLLM 中使用 Ace Data Cloud
内容提要
本文介绍如何在AnythingLLM中接入Ace Data Cloud：先获取API Token，下载桌面版或Docker部署；在LLM Preference选择OpenAI (Generic)，填入Base URL（以/v1结尾）和API Key；Embedding用本地内置Embedder即可。推荐GPT、Claude等模型，可用curl验证对接，并支持Workspace文档对话，常见问题包括404、401及本地数据不上云。
延伸解读
Base URL 路径规则易踩坑
配置 OpenAI (Generic) 时，Base URL 必须以 /v1 结尾，否则请求会 404。例如 https://api.acedata.cloud/openai/v1 会因缺少 /v1 而失败，而 https://api.acedata.cloud/openai 虽可用但非标准。建议直接使用官方推荐的 https://api.acedata.cloud/v1，避免路径拼接错误。
本地嵌入与云端模型分离
AnythingLLM 的嵌入模型和对话模型相互独立。本文推荐使用内置的本地 Embedder，文档向量化在本地完成，数据不上云，仅将检索片段和问题发送给云端模型。这种设计兼顾隐私与模型能力，适合对文档内容敏感的私有化场景。
验证对接的实用技巧
若对接失败，可先用 curl 直接请求 /v1/chat/completions 验证 Token 和端点是否正常。返回 OpenAI 兼容对象说明配置无误；若返回 403 used_up，则表明 Token 有效但余额不足。这能快速定位问题是在网络、Token 还是配置上。
Q&A
如何在AnythingLLM中配置Ace Data Cloud作为对话模型？
在AnythingLLM中，进入Settings → LLM Preference，Provider选择OpenAI (Generic)，Base URL填写https://api.acedata.cloud/v1，API Key填入从Ace Data Cloud控制台复制的Token，Selected Model选择如gpt-5等模型，然后保存即可。
AnythingLLM的Base URL应该填什么？为什么必须以/v1结尾？
Base URL应填写https://api.acedata.cloud/v1，必须以/v1结尾，因为AnythingLLM会在此基础上拼接/chat/completions路径。如果缺少/v1或路径错误，会导致404错误。
在AnythingLLM中，Embedding模型应该怎么配置？
推荐使用AnythingLLM内置的本地Embedder（AnythingLLM Embedder），无需额外配置，在Settings → Embedding Preference中保持默认即可。它会在本地完成文档向量化，不上传云端。
Ace Data Cloud支持哪些模型可以在AnythingLLM中使用？
支持GPT系列（如gpt-5、gpt-5-mini、gpt-4o）、Claude系列（如claude-opus-4-8、claude-sonnet-4-6）、Gemini系列（如gemini-3.1-pro、gemini-3-flash-preview）、Grok（grok-4）和DeepSeek（deepseek-v3）等模型。具体可用性以Ace Data Cloud服务文档为准。
如何验证Ace Data Cloud的API对接是否成功？
可以使用curl命令直接调用API，例如：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对象，则对接成功；若返回HTTP 403 used_up，则表示Token有效但余额不足。
在AnythingLLM中上传文档后，本地文档会传到云端吗？
不会。文档原文和向量都存储在本地LanceDB中，只有检索命中的片段和你的问题会发送给对话模型（Ace Data Cloud），因此本地文档不会上传到云端。
在AnythingLLM中遇到404错误怎么办？
404错误通常是因为Base URL填写错误，比如写成了.../openai/v1或漏了/v1。请将Base URL改为https://api.acedata.cloud/v1。
在AnythingLLM中提示401 Unauthorized是什么原因？
401错误通常是因为API Key不正确，请确认粘贴的是Ace Data Cloud的Token，且不含Bearer前缀、无多余空格，并确保账户余额充足。
