申請流程
要在 ChatBox 中串接 Ace Data Cloud,首先到 Ace Data Cloud 控制台,取得您的 API Token,留作備用。
如果你尚未登入或註冊,會自動跳轉到登入頁面邀請您來註冊和登入,登入註冊之後會自動返回目前頁面。
在首次申請時會有免費額度贈送,可以免費體驗 Ace Data Cloud 的模型服務。
下載 ChatBox
到 ChatBox 官網 按平台下載,或直接使用免安裝的 Web 版:- 桌面:Windows
.exe、macOS.dmg(區分 Intel / Apple Silicon)、Linux AppImage - 行動:App Store、Google Play、官網安卓直鏈
設定 Ace Data Cloud
啟動 ChatBox,進入 設定 → 模型 → 新增自訂 Provider,將 API Mode 設為 OpenAI API Compatible,然後填入:
ChatBox 的請求路徑是 {API Host} + {API Path},因此 Host 只填根網域即可:
ChatBox 不會自動呼叫
/v1/models,需要在模型設定頁底部的「自訂模型」輸入框中手動填寫模型 ID(每行一個),儲存後即可在對話介面的模型下拉選單中選擇。能力開關、上下文視窗和輸出上限必須按所選模型的目前合約填寫,不要照抄其他模型的數值。
選擇模型
模型目錄會持續更新。優先使用用戶端自動載入的模型列表;需要手動填寫時,先請求GET https://api.acedata.cloud/v1/models 取得目前模型 ID,再按用戶端支援的上下文、圖片和工具呼叫能力選擇。
驗證串接
如果不確定問題出在 ChatBox 還是網路,可以先用 curl 直接驗證端點(把{token} 替換為你的 Token):
chat.completion 物件即說明 Token 與端點都已就緒;若返回 HTTP 403 used_up 則表示 Token 有效但餘額不足,到 控制台 儲值即可。
常見問題
提示 404 Not Found
通常是 API Host 多加了/openai 或 /v1。Host 只填 https://api.acedata.cloud,路徑交給預設的 /v1/chat/completions。
提示 401 / token_mismatched
請確認「API 金鑰」中貼上的是 Ace Data Cloud 的 Token(不含Bearer 前綴、無多餘空格),且所屬應用程式的餘額充足。
模型下拉選單裡看不到模型
ChatBox 不會自動拉取模型列表,必須在「自訂模型」框裡手動填寫模型 ID 並儲存。想在 ChatBox 裡生成圖片
Ace Data Cloud 的圖像生成是獨立的 Images API(/openai/images/generations),與對話介面不同路徑,ChatBox 的圖像入口無法直接串接。如需繪圖,請參考 圖像生成 API 文件 用 curl / SDK 呼叫。

