DEVELOPER DOCUMENTATION
聊天客戶端設定指南
以欄位對照規劃 OpenAI 相容客戶端,先核對網址拼接、金鑰儲存及模型識別碼。
先確認客戶端與連線規格
網站維護中。以下僅為規劃中的設定教學;api.ubtl.net 是預定網域,本文沒有執行真實 API 測試,也不代表服務已可連線。使用前須確認實際開放的協定、路徑與模型識別碼。
Chatbox、NextChat、LobeChat、TypingMind 與 Open WebUI 可作為查閱設定的起點,但不同版本、部署方式及供應商介面可能不同;這份教學不保證每款客戶端都能使用。先查看所選版本是否提供自訂 OpenAI 相容端點,再備份現有設定或建立獨立設定檔。
對照網址、金鑰與模型欄位
下列 JSON 只是欄位對照示意,不是任何應用程式通用的設定檔或匯入格式。預定 Base URL 為 https://api.ubtl.net/v1;若客戶端要求主機根網址,或會自動附加版本與請求路徑,必須先核對其文件,避免重複加入 /v1。不要把完整聊天請求路徑直接當作所有欄位的值。
YOUR_UBTL_API_KEY 與 YOUR_MODEL_ID 都是佔位符,不能直接當作有效憑證或模型。日後取得授權資料時,使用獨立金鑰並確認其儲存位置;多人使用的部署須檢查後端秘密管理與存取權限,不要把私人金鑰放入公開前端設定、匯出檔或程式庫。API 存取與 ChatGPT 網頁訂閱是不同事項,無須提供網頁密碼或 cookies。
{
"provider": "OpenAI-compatible",
"base_url": "https://api.ubtl.net/v1",
"api_key": "YOUR_UBTL_API_KEY",
"model": "YOUR_MODEL_ID"
}重新載入與最小驗證
儲存後依客戶端要求重新開啟應用程式或重新載入部署,先檢查已選供應商、組合後網址及模型名稱。只有在服務公告確認可用且端點規格明確後,才傳送不含私人資訊的短訊息作最小測試。認證錯誤先查金鑰載入與權限;路徑錯誤先查版本字串是否重複;模型錯誤則核對完整識別碼。分享紀錄前移除認證標頭,必要時還原備份。