Skip to main content
LobeChat 是支援外掛程式、知識庫和自行部署的開源 AI 用戶端,可使用線上版或透過 Docker 部署。它支援自訂 OpenAI 相容端點,因此可以串接 Ace Data Cloud。本文介紹設定流程。

申請流程

要在 LobeChat 中串接 Ace Data Cloud,首先前往 Ace Data Cloud 控制台,取得您的 API Token,留作備用。 取得 Ace Data Cloud API Key 如果你尚未登入或註冊,會自動跳轉至登入頁面邀請您註冊和登入,登入註冊之後會自動返回目前頁面。 首次申請時會贈送免費額度,可以免費體驗 Ace Data Cloud 的模型服務。

設定 Ace Data Cloud

進入 LobeChat 的 應用程式設定 → 語言模型,找到 OpenAI 卡片並啟用,填入: LobeChat OpenAI Provider 設定介面
使用 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):
回傳 OpenAI 相容的 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 前綴、無多餘空格),且所屬應用程式的餘額充足。

了解更多