TL;DR
TypingMind 是一款靈活的 AI 對話介面，允許你使用自己的 API 金鑰連接 GPT、Claude、DeepSeek 與其他受支援的模型。透過以 OpenAI 相容的方式整合 CometAPI，你可以在不為每個供應商單獨設定帳戶的情況下存取多個 AI 模型。本指南說明如何使用你的 CometAPI API 金鑰與 Chat Completions 端點新增自訂模型、傳送第一則訊息，並排解常見的設定錯誤。你需要 CometAPI API 金鑰、可用的帳戶額度，以及對 TypingMind 自訂模型設定的存取權。先從基本文字提示開始，視需要再啟用進階功能。文末另提供可選的 Bash 與 cURL 範例以測試 API 連線。
Key Takeaways
- 一把 API 金鑰，存取多種模型：透過單一 CometAPI 帳戶存取受支援的供應商。
- OpenAI 相容整合：無需自訂 SDK，即可設定標準的 Chat Completions 端點。
- 彈性的模型選擇：在 TypingMind 中註冊多個由 CometAPI 提供的模型。
- 分離計費：模型推論由 CometAPI 計費；TypingMind 授權費用獨立。
什麼是 TypingMind
TypingMind 是一個 AI 對話介面，透過你提供的 API 金鑰連接各種模型。它將模型選擇與對話管理集中於同一處。TypingMind 提供介面；已連接的 API 服務負責處理模型請求與用量計費。
CometAPI 為來自多個供應商的受支援模型（包含 GPT、Claude、Gemini、DeepSeek）提供一個共用的 API 連線以供 TypingMind 使用。你可以透過單一 CometAPI 帳戶管理 API 存取與計費，並在 TypingMind 中為想使用的模型分別建立自訂模型項目。如此即可更輕鬆地嘗試不同模型來撰寫、寫程式或處理日常問題，而無需為每家供應商分別設定 API 帳戶。
在將 CometAPI 連接到 TypingMind 之前需要準備什麼？
在 CometAPI 帳戶的 API Keys 區段建立金鑰，並依照建立金鑰指引操作。為此次連線使用專用金鑰，以便在不影響其他整合的情況下撤銷。請勿將金鑰出現在螢幕擷圖、共用文件與公開版本庫中。
CometAPI 支援多個模型家族，包含 GPT、Claude、Gemini 與 DeepSeek；並不限於 GPT-6 Luna。本教學僅以 GPT-6 Luna（模型 ID：gpt-6-luna）作為設定表與終端機測試的範例。只要你的帳戶可存取，且該路由支援 OpenAI Chat Completions，你可以從 CometAPI 模型目錄選擇其他模型。
使用其他模型時，請在 TypingMind 與 cURL 請求中將 gpt-6-luna 替換為該模型的精確 ID。並相應更新顯示名稱、上下文長度、定價與功能設定，以符合所選模型。請勿假設範例模型的設定適用於所有模型。
請使用下列設定。TypingMind 需要完整的端點 URL；以 /v1 結尾的 SDK 基底 URL 屬於不同欄位，請勿在此替代。
| TypingMind 欄位 | 值 |
|---|---|
| 名稱 | GPT-6 Luna 透過 CometAPI |
| 模型 ID | gpt-6-luna |
| API 類型 | OpenAI Chat Completions API |
| 端點 URL | https://api.cometapi.com/v1/chat/completions |
| 驗證方式 | API Key via HTTP Header |
| 標頭鍵 | Authorization |
| 標頭值 | Bearer YOUR_COMETAPI_API_KEY |
如何將 CometAPI 新增到 TypingMind？
建立自訂模型
開啟 TypingMind，選取 Models，然後選擇 Add custom model。保持 Create Manually 為勾選狀態。手動設定流程文件說明了這些控制項。
輸入模型詳細資訊
從設定表複製名稱與模型 ID。若需要填寫 Context Length，請使用所選模型文件記載的上限；GPT-6 Luna 的已記載上下文視窗為 1,050,000 個 tokens。上下限是容量設定，並非建議實際傳送如此多的 tokens。
設定端點與驗證
在 Authentication 中，依表格輸入 API 類型、端點、標頭鍵與標頭值。將 YOUR_COMETAPI_API_KEY 替換為你的實際金鑰。Bearer 後需留一個空格，且不加上引號。
兩張螢幕擷圖皆來自 TypingMind 官方指南。空白的驗證表單僅用於示意欄位位置；請輸入你自己的 CometAPI 端點、模型 ID 與金鑰。
測試並儲存連線
先以文字對話開始，保持可選的請求覆寫為未設定。點擊 Test & Save，選取已儲存的模型，並傳送：「請用三句話說明 REST API 與 WebSocket 的差異。」若能看到助理回覆，即代表基本連線成功。再傳送一則追問以確認對話可持續進行。
啟用可選功能
請先從文字對話開始。僅在受支援時再啟用串流、系統提示、影像輸入、工具或推理控制。進階功能請分別測試。
TypingMind 的功能設定提供自動偵測與手動控制。請將偵測結果視為起點：需針對所選模型與路由逐一驗證各功能。保留一套可用的基本設定，以便在功能測試失敗時移除最近新增的覆寫。
如何在 TypingMind 外檢查 CometAPI 請求？
當 Test & Save 失敗時使用此選擇性測試。它會使用相同的金鑰與模型 ID，依照 CometAPI 的Chat Completions 請求格式送出最小化請求。無需更改 TypingMind 的設定。
在目前的 Bash 會話中設定金鑰
在 Bash（包含 Windows 上的 Git Bash 或 WSL）中執行以下指令。於隱藏提示處貼上金鑰。這些指令使用 Bash 語法，不應原樣貼到 PowerShell。
read -r -s -p "CometAPI API key: " COMETAPI_API_KEYprintf '\n'export COMETAPI_API_KEY
傳送最小化的對話請求
curl --include --silent --show-error \ https://api.cometapi.com/v1/chat/completions \ -H "Authorization: Bearer $COMETAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-luna", "messages": [ {"role": "user", "content": "Explain API gateways in one sentence."} ] }'
檢視 choices[0].message.content 以取得助理回覆文字。若 cURL 回傳 HTTP 錯誤，請先閱讀回應本文再變更設定。若終端請求成功但 TypingMind 失敗，請比對端點、金鑰、模型 ID 與可選覆寫，接著檢查瀏覽器的 Network 面板。終端成功僅能確認該請求路徑可用；並不能驗證瀏覽器的存取或所有模型功能。
移除暫時的環境變數
unset COMETAPI_API_KEY
如何排解 TypingMind 連線錯誤
使用回應本文與瀏覽器 Network 面板找出失敗的請求。以下檢查為起始方向，而非僅依狀態碼下結論。請勿在螢幕擷圖與支援訊息中暴露認證資訊。
| 症狀 | 首要檢查 | 下一步行動 |
|---|---|---|
| 401 Unauthorized | 金鑰與 Authorization 標頭 | 檢查金鑰是否過期或已撤銷、是否有多餘空白、或缺少 Bearer 前綴。 |
| 403 Forbidden | 回應本文與模型存取權 | 確認帳戶權限與所選路由的存取權。 |
| 404 Not Found | 端點與精確模型 ID | 使用完整的 /v1/chat/completions URL，並在目錄中確認該 ID。 |
| 400 Bad Request | 請求本文與覆寫 | 移除可選參數並以純文字請求重試。 |
| 429 Too Many Requests | 配額或頻率限制錯誤細節 | 檢查帳戶限制與額度。暫停因頻率限制而重試的請求；在配額恢復後再重試。 |
| 瀏覽器網路錯誤 | Network 面板與主控台 | 檢查連線狀態與是否有跨來源錯誤；並與終端測試結果比較。 |
| 串流失敗 | 串流設定與路由支援 | 停用串流後再重試，以定位失敗原因。 |
由於跨來源限制，API 可能在 Python 或 cURL 中可用，但在瀏覽器中失敗。請勿為繞過 CORS 而透過不安全的公共代理暴露未受限制的 API 金鑰。
常見問題
在新增 CometAPI 的同時，是否可以保留既有的 TypingMind 連線？
可以：請建立一個獨立的自訂模型項目，使用易於辨識的顯示名稱，而非編輯現有的供應商項目。在驗證 CometAPI 連線期間，保留原本的端點與模型設定。請先在新對話中測試，以避免既有對話的長度或附件掩蓋基本設定錯誤。
如何輪替在 TypingMind 中使用的 CometAPI 金鑰？
建立替代金鑰，更新所有使用舊金鑰的自訂模型項目，並從每個項目發送新請求進行測試。在替代金鑰可用後，再撤銷舊金鑰。若舊金鑰已外洩，請立即撤銷，並以新金鑰恢復受影響的連線。
為什麼 TypingMind 的成本估算可能與 CometAPI 帳單不同？
TypingMind 會依據其 Pricing 設定中輸入的費率來估算用量。過時的費率，或快取、上下文分層、推理權杖計費方式的差異，都可能導致不一致。請將模型的最新費率與特定請求的用量，對照 CometAPI 計費資訊；切勿將用戶端的估算視為最終收費。
結論
要將 CometAPI 連接到 TypingMind，請建立手動自訂模型、輸入完整的 Chat Completions 端點、加入 Authorization 標頭，並以純文字訊息進行測試。在新增可選功能前，保留一套可用設定。當設定失敗時，最小化的 cURL 請求可協助區分帳戶或 API 錯誤與瀏覽器／前端設定問題。