CometAPI

CometAPI 是什麼

CometAPI是一個面向開發者與企業的多模型API聚合平台，透過一套帳戶、金鑰及計費體系，將不同廠商所提供的文字、圖像、影片和音頻模型連接起來。它主要用於解決各種模型接口的格式、金鑰、帳單處理以及切換邏輯分散的問題。

產品說明頁面指出，CometAPI是由Sonic在2025年1月所創立，其服務對象為全球的專業用戶；相關公開條款適用香港法律。目前的公開頁面並未列出完整的營運法人名稱，企業在採購時應在合約、發票及資料處理文件中進一步確認簽約主體。

主要功能

統一模型目錄與介面

• 透過單一 CometAPI 金鑰來呼叫多個供應商的模型，可處理對話、推理、編程、圖像生成與分析、影片、語音及音樂等各種任務。
• 公開模型目錄提供模型識別碼、供應商、功能、可用端點及計費資訊，應用可在運行前查詢當前目錄。
• 常見的文字、圖像、音頻和影片處理流程，都採用與 OpenAI 相容的請求格式；而那些已經有 OpenAI SDK 的專案，通常只需替換基礎網址、金鑰以及模型識別碼，就能開始進行遷移測試了。
• 並非每個模型都支援完全相同的參數、輸入或返回結構，接入前需要查閱該模型的端點說明，不能僅替換模型名稱。

文字、圖像、影片與音頻能力

模型切換與故障回退

• 應用可以在保持同一密鑰和介面地址的前提下，把主模型切換為能力相容的備用模型。
• 官方文件建議僅對連接失敗、超時、限流和臨時服務端錯誤執行回退；參數錯誤、金鑰錯誤和不受支援的欄位應直接修復。
• 如需再回退到模型廠商直連接口，必須另備廠商帳戶、密鑰、預算和模型識別碼，直連產生的費用也會單獨結算。
• 跨模型家族時要統一輸入和輸出字段，並驗證工具調用、視覺、上下文長度和結構化輸出等必需能力。

異步任務、輪詢與回呼

• 影片等長任務創建後會返回任務識別碼，應用可輪詢任務狀態，直到成功、失敗或取消。
• 只有當所選的端點明確支援時，才能設定回呼地址；各供應商的回呼處理方式並不統一，應用程式應儲存原始事件並自行進行規範化處理。
• 輪詢應作為遺失回呼時的最終狀態依據，回呼處理需按任務識別碼實現冪等，避免重複通知造成重複入庫。
• 完成結果可能透過結果欄位或內容下載端點返回，具體形式以模型頁面為準。

工作區與團隊管理

• Workspace 用於管理組織內的成員，Owner 與 Admin 可以邀請或移除成員，Member 則可以查看成員列表。
• 工作區不單獨持有 Credits，成員請求共用組織餘額；只有 Organization Owner 能充值、設定自動充值或兌換餘額碼。
• 邀請在 24 小時後失效，移除成員時會刪除該成員在工作區創建的 API 密鑰記錄。
• 團隊應為環境與服務分別建立金鑰，並配合額度限制、輪換及人員離職流程，不要多人共享同一長期金鑰。

完整接入流程

1. 註冊並進入控制台，先查看目前模型目錄、端點能力與計費單位，選出主模型及能力相近的備用模型。
2. 建立名稱清晰的 API 金鑰，可依專案設定額度上限；複製後儲存在伺服器端金鑰管理系統或環境變數中。
3. 在現有的 OpenAI 用戶端中替換介面基礎地址和金鑰，或安裝官方 SDK，再填寫目錄中的準確模型識別碼。
4. 以簡短提示進行最小調用，記錄回應內容、模型識別碼、Token 用量、延遲及請求識別碼，確認請求格式正確。
5. 根據業務需求，可補充流式輸出、結構化結果、圖片或異步媒體流程，請勿向不支援的模型傳送相同的參數。
6. 為限流和臨時錯誤加入指數退避、隨機抖動與併發上限；對無效請求和認證失敗停止重試。
7. 在控制台檢查餘額與用量，依據真實呼叫記錄設定預算、金鑰額度及自動儲值閾值。
8. 上線前測試主模型、備用模型和必要的廠商直連回退，並建立模型下線、價格變化和異常帳單告警。

開發介面與 SDK

官方的 Node.js 與 TypeScript SDK 均要求在伺服器端使用，並明確提醒不要將長期密鑰放入瀏覽器代碼、日誌、截圖或公開的儲存庫中。目前 0.1.x 版本僅支援對話處理、回應資料以及模型列表的功能，而圖像、影片、音頻、批次處理、微調以及即時處理等功能則不在該 SDK 的支援範圍內。

價格與計費方式

CometAPI採用預付 Credits的按量計費模式，不收取固定的月費、最低消費金額或訂閱費用。用戶充值後，會根據實際使用的 Token數量、生成的資產數量或使用時長來扣費，只要帳戶狀態正常，購買的餘額就不會過期。

不同模型的定價口徑

價格頁面同時顯示不同型號的即時單價，型號的上線、下線以及廠商的價格都可能有所變動。預算應以相同型號的當前輸入價、輸出價或任務單價來估算，並在完成任務後再根據實際帳單進行修正。

自動充值與失敗請求

• 用戶可在帳戶中設定，當餘額低於閾值時透過 Stripe 自動充值，並可隨時修改或關閉該設定。
• 網關在轉發前因參數或認證而拒絕的請求不計費，上游返回服務端錯誤的請求也不計費。
• 流式生成在已返回內容後中斷，通常會依照已生成的 Token 來計費；雖然成功完成，但結果不符合主觀預期的請求則會被全額計費。
• 餘額不足或付款失敗時，平台可以暫停或限制服務，生產系統不應僅依賴自動儲值來維持連續性。

退款規則

• 已使用或消耗的 Credits、API 調用和計算時間不退款，餘額也不可轉讓或兌換現金。
• 未使用的 Credits 可提交書面申請，但是否批准由 CometAPI 審核決定，並非預設的退款權利。
• 申請應包含充值金額、購買日期、目前未用餘額及原因；退款政策則註明通常會在 5 個工作日內回覆。
• 獲批退款時，會盡可能以原支付方式退回，而由支付機構、銀行或中介方所收取且無法退還的處理費，則可能會被扣除。
• 疑似錯誤扣費應在扣費日起 30 天內提出異議，超期可能被視為接受該筆費用。

適合用戶與場景

• 希望用一套接口比較和切換多家模型的應用開發團隊。
• 需要在客服、內容、搜尋、編程或代理系統中動態選擇成本與能力的產品團隊。
• 批量生成圖片、短影片、配音或音樂，同時希望統一餘額和賬單的創意技術團隊。
• 需要為成員分配工作區、共享組織餘額並集中管理金鑰的企業研發部門。
• 需要多模型回退或希望減少單一模型廠商綁定的基礎設施團隊。

優勢與能力邊界

• 統一密鑰、目錄和帳單能減少重複接入，但聚合層並不會消除各模型在參數、內容政策、能力和輸出品質上的差異。
• 平台支援模型內回退，但錯誤分類、冪等性、隊列、超時以及最終的廠商直連仍需由應用自行設計。
• 限流額度會受帳戶、模型、路由和上游容量影響；宣傳中的高容量不應替代生產壓測和合約承諾。
• 公開模型數量和具體型號會持續變化，生產環境必須固定模型識別並監控下線公告。
• 模型輸出可能不準確、侵權或不適合業務，使用者仍需進行事實、安全、版權和合規審核。
• 未經書面授權不得轉售、再許可或重新分發服務，商業平台如需將 API 功能提供給下游客戶，應先確認授權方式。

隱私、安全與合規

• 隱私政策稱 CometAPI 不收集、儲存或記錄提示、輸入、輸出和對話內容，也不會把這些內容保存到自身資料庫。
• 請求仍會實時路由給實際模型提供商以產生結果，因此每個上游提供商的資料處理、保留及內容政策仍需單獨審查。
• 平台會收集有限的 IP 地址、時間、請求頻率、瀏覽器、裝置及訪問記錄，用於安全、合規、分析與服務優化。
• 帳戶註冊時可能會收集用戶名稱和電子郵件地址，使用 GitHub 或 Google 登入時則會在用戶同意後取得用於認證的用戶名稱和電子郵件地址。
• 平台聲明不出售、出租或交易個人資訊，但在法律或監管要求下可能披露相關資訊，並聲明已採取合理技術與組織措施，但無法保證絕對安全。
• 企業在頁面上將 SOC 2 Type II 列為正在推進的計畫項目，因此無法以此判斷該平台目前已取得此項認證。

API 密鑰安全建議

1. 為開發、測試和生產分別建立金鑰，設定合理的額度，並僅儲存在伺服器環境變數或金鑰管理系統中。
2. 禁止把密鑰寫入瀏覽器套件、行動用戶端、公開代碼倉庫、日誌、截圖或支援工單。
3. 日誌只保留模型識別碼、狀態、延遲和請求識別碼等排錯欄位，不記錄金鑰或不必要的使用者原文。
4. 發現洩漏後立即撤銷並輪換密鑰，核查異常用量、自動儲值和成員權限。

開源狀態與平台支援

總結

CometAPI適合那些需要快速接入多個模型、統一管理資金餘額，同時還要能夠自由切換模型的開發團隊。其實際價值取決於目標模型是否穩定可用、接口是否具備完整的相容性，以及團隊是否能妥善管理成本、密鑰、重試機制以及上遊供應商的政策。

開始使用時，建議先使用試用 Credits 進行最簡單的測試，再以真實的業務資料來檢驗其品質、延遲時間及費用。在準備正式部署或進行大量儲值之前，還應確認模型的生命週期、企業服務等級、簽約主體、退款條件以及上游數據處理的要求。