申請流程
要在 LobeChat 中串接 Ace Data Cloud,首先前往 Ace Data Cloud 控制台,取得您的 API Token,留作備用。
如果你尚未登入或註冊,會自動跳轉至登入頁面邀請您註冊和登入,登入註冊之後會自動返回目前頁面。
首次申請時會贈送免費額度,可以免費體驗 Ace Data Cloud 的模型服務。
設定 Ace Data Cloud
進入 LobeChat 的 應用程式設定 → 語言模型,找到 OpenAI 卡片並啟用,填入:
使用 Chat Completions 介面時,請保持 Responses API Specification 關閉。LobeChat 不會自動為 Base URL 加上
/v1,請求路徑直接是 {API 代理位址}/chat/completions:
LobeChat 預設會呼叫
/v1/models 自動取得模型,Ace Data Cloud 回傳的模型較多時介面會很長,建議在「模型清單 → 自訂模型名稱」中手動填寫一個 allow list,以英文逗號分隔。如需自訂顯示名稱,可以使用 =,格式為 MODEL_ID=顯示名稱。
選擇模型
模型目錄會持續更新。優先使用用戶端自動載入的模型清單;需要手動填寫時,先請求GET https://api.acedata.cloud/v1/models 取得目前模型 ID,再依用戶端支援的上下文、圖片和工具呼叫能力選擇。
驗證串接
如果不確定問題出在 LobeChat 還是網路,可以先使用 curl 直接驗證端點(將{token} 替換為你的 Token):
chat.completion 物件即表示 Token 與端點都已就緒;若回傳 HTTP 403 used_up 則表示 Token 有效但餘額不足,前往控制台儲值即可。
進階:Docker 自行部署
如果希望部署一份私有版供團隊使用,可使用 Docker 一行指令啟動(將{token} 替換為你的 Token):
http://你的伺服器IP:3210,輸入 ACCESS_CODE 即可使用,團隊成員無需各自填寫 Key。上面使用的 OPENAI_API_KEY、OPENAI_PROXY_URL、OPENAI_MODEL_LIST 等環境變數的完整說明請參閱 LobeChat 模型服務供應商環境變數文件。若使用 nginx 反向代理加上 HTTPS,請務必加上 proxy_buffering off;,否則串流回應會被緩衝。更多部署型態請參考 LobeChat 自行部署入門 與 Docker Compose 部署。
常見問題
提示 404 Not Found
通常是 API 代理位址寫成了.../openai/v1 或漏了 /v1。改成 https://api.acedata.cloud/v1。
模型清單為空
開啟「用戶端請求模式」開關;或在「自訂模型名稱」中手動填寫模型 allow list。提示 401 Unauthorized
請確認 API Key 中貼上的是 Ace Data Cloud 的 Token(不含Bearer 前綴、無多餘空格),且所屬應用程式的餘額充足。

