Convex

Convex 是什麼？

Convex 是結合資料庫、伺服器函式與用戶端程式庫的響應式後端平台。查詢是與資料庫一同執行的 TypeScript 程式碼，訂閱結果會隨儲存資料的變化而更新。

Convex 即時資料庫採用關聯式資料模型，同時儲存類似 JSON 的文件。Schema 可選，文件可參照其他資料表中的文件，應用程式透過 JavaScript API 而非 SQL 讀寫。

Convex 也透過 AI Gateway 提供代管模型存取：後端 action 呼叫此服務，供應商憑證由 Convex 持有，短期存取權杖限定於某個部署。

核心功能

查詢、變更與 action

函式類型劃分不同的執行邊界：

• 查詢讀取資料，有快取並支援響應式訂閱。
• 變更寫入資料，並作為資料庫交易執行。
• Action 呼叫外部 API，不具交易性，也不快取。
• HTTP action 提供 webhook 或自訂用戶端端點。

代管模型存取

AI Gateway 提供文字生成、嵌入、決策、圖像、影片、語音生成與轉錄路由。Decisions、Voice 及圖像/影片生成處於 alpha 階段，請求與回應格式可能變更。

使用指南

連接 React 介面

既有 Convex 後端可透過以下基本元件連接 React 介面：

1. 為部署建立 ConvexReactClient，傳給包覆元件樹的 ConvexProvider。
2. 使用 useQuery 與產生的 api 物件讀取後端資料。開發指令會在 convex/_generated/api.js 產生物件，提供 JavaScript 自動完成與端到端 TypeScript 型別。
3. 使用 useMutation 修改資料。該 hook 回傳非同步函式；以參數呼叫函式即可執行變更。

Convex 使用情境

• 即時聊天介面： Convex 提供即時聊天應用程式教學，訊息持久保存並即時更新。
• 語意檢索與推薦： 向量搜尋尋找與所給向量相似的文件。文件列出的用途包括 LLM 應用程式的上下文與相關內容推薦。
• 持久化代理： Agent 元件跨工作階段保存對話歷史，將長時間執行的 AI 工作與響應式介面分離。它支援對歷史進行向量/文字混合搜尋，並透過 RAG 元件或自訂實作，使用其他來源進行以 RAG 為基礎的提示詞增強。
• 延遲與週期工作： 排程函式稍後執行一次，cron 工作週期執行。例如歡迎郵件與帳戶對帳；Workpool 和 Workflow 元件加入具有重試與延遲功能的佇列或持久流程。

適用人群

• JavaScript 與 TypeScript 應用程式開發者： TypeScript 後端也接受 JavaScript；函式透過用戶端程式庫 API 提供，適合同時負責介面與伺服器程式碼的團隊。
• 尋求代管營運的團隊： Convex 將代管產品定位為較省維運；自行架設則在團隊自己的伺服器上執行目前的後端程式碼。

支援平台

• React 用戶端： ConvexReactClient 使用 WebSocket 推送結果，無須輪詢，連線中斷後會重新連線。
• 前端託管： 前端可使用 Vercel、Netlify 或自訂託管，與後端部署分開。
• 身分驗證： 連線/呼叫使用 OpenID Connect JWT。Convex Auth 支援用戶端 React 和 React Native 註冊/登入流程，但仍為 beta，功能少於第三方整合。
• 資料區域： 可部署於北維吉尼亞、愛爾蘭、雪梨或加拿大中部。美國以外用量加收 30%（標準費率的 1.3 倍）。

支援部署的所有基礎設施都託管在所選區域。變更區域須建立新專案或部署並匯出/匯入資料，既有部署無法就地遷移。

價格套餐

價格擷取於 2026 年 11 月 2 日，以顯示的美國東部基準美元計價。包含的資源跨區域共用。

方案與開發者存取

Business 列出每月最低 $2,500；部署類別與基礎設施單價另行公布。Enterprise 列出年度承諾折扣，但未給出具體折扣或年度總價。

Free、Starter 與 Professional 資源

每個儲存格列出包含額度與額外用量費率。第一欄的付費超額適用於 Starter；Free 額度固定。儲存按 GB/月計費，其他資源依各自所列單位計量。

無伺服器查詢/變更運算免費。呼叫包括用戶端呼叫、排程、訂閱更新與檔案存取。檔案儲存包括備份；輸出流量包括函式檔案存取及備份產生/還原。文字/向量索引與查詢分別共用相應的搜尋計量。

用量彙總於團隊所有專案，不按專案或開發者分別分配。Free 方案長期超額可能造成 HTTP 錯誤，但 Convex 表示不會因超額刪除已成功寫入的變更紀錄。FAQ 提到 Starter，也用「Starter Plus」表示持續流量；不能據此推斷另有單獨定價的層級。

Business 與 Enterprise 部署費率

美國東部月費矩陣列出四個類別；啟用的部署按日比例計費。其他單位見各列。

以下基礎設施計量與部署類別同時適用：

破折號保留公布值，不表示價格為零或包含該權益。

AI 費用與支出控制

AI Gateway 要求付費團隊，支援雲端正式/開發環境或與專案關聯的本機部署。Free 和自行架設的部署不能使用；自行架設的 action 可使用自己的金鑰呼叫供應商。

Gateway 費用取決於模型、時間、快取 token、圖像/影片解析度與長度，或語音字元數/秒數/token。費用出現在 Convex 帳單上；取消已送出的影片請求仍可能產生生成費用。

雲端部署支援 AI Gateway 每日/每月停用門檻：觸發時停用整個部署，而非僅模型請求；非開發部署也支援警告門檻。專案關聯的本機請求共用團隊支出上限；達到上限後，進行中的請求或使用已簽發短期憑證的請求仍可能完成。

續約與退款

費用不可取消或退款，明定的合約例外除外。Order Form 決定每月/每年週期；自助超額自動計費，達到帳單門檻時可能產生中途收費。

Order Form 訂閱以相同期間自動續約，除非任一方在到期至少 60 天前通知不續約。若客戶選擇不自動續約，訂閱依目前條款及價格轉為逐月續約；任一方可提前 30 天書面通知終止。

若 Convex 在收到書面違約通知後 30 天內未補救重大違約，客戶作為非違約方可書面通知終止協議或受影響的 Order Form。若客戶依此條款終止協議，Convex 退還截至終止生效日已終止 Order Form 剩餘期間內預付但未使用費用的按比例金額。這是合約例外，並非一般試用退款期。

Convex 替代方案

Supabase 提供按專案劃分的 Postgres、身分驗證、具 Row Level Security 的儲存、即時服務與 Edge Functions。其 Postgres 基礎使其成為面向 SQL 團隊的相關替代方案。

Firebase Cloud Firestore 提供適用於行動裝置、網頁及伺服器的 NoSQL 資料庫，並有即時監聽器與行動裝置及網頁的離線支援。文件所述離線行為解決斷線存取問題，但不能證明 Convex 具備同等行為。

注意事項

交易與執行邊界

• 外部副作用： action 發生錯誤時不自動重試，因為外部請求可能已生效。呼叫方處理重試；回傳後未完成的 promise 可能完成，也可能不會。
• 獨立交易： action 透過查詢與變更間接存取資料庫。獨立的 runQuery/runMutation 呼叫不一定共用一致狀態；一個合併的查詢/變更具有一致的交易邊界。
• 文件大小： 文件上限 1 MiB，巢狀深度上限 16。
• 交易大小： 一次查詢或變更最多讀取 16 MiB、寫入 16 MiB。掃描後被篩選器排除的資料仍計入讀取量。

Action 指南稱 action 在 10 分鐘後逾時；限制參考則列出 Convex 執行階段 action 為 30 分鐘、Node 執行階段 action 為 10 分鐘，查詢/變更使用者程式碼為 1 秒且不含資料庫操作。這些公開描述不一致。

搜尋與生成邊界

向量搜尋僅限 action，使用餘弦相似度進行近似最近鄰搜尋。結果成員本身不具響應性，但個別查詢可使每個結果的資料保持響應式；紀錄在取回前可能變動或消失。每張資料表允許四個向量索引，維度為 2 至 4,096。

圖像/影片生成處於 alpha，請求/回應格式可能變更。圖像使用文字提示詞，不支援輸入圖像或遮罩編輯。同步影片約 5 分鐘後失敗，允許下載 64 MiB；取消、逾時或回應遺失仍可能收費。非同步操作在 7 天後到期；供應商保留影片的時間可能更短。

自行架設授權

後端的 FSL Apache 2.0 公平原始碼授權不允許建立旨在與代管的 Convex Cloud 競爭的產品。程式碼建立兩年後轉為 Apache 2.0；目前版本從第一天起並非不受限制的 Apache 2.0。

指定 Beta Features 僅供評估，不屬於合約中的 Platform，且不提供服務承諾、支援、保證或使用責任；Convex 可停止提供。

資料權利與模型處理

客戶/授權方保留 Customer Data 權利，並授予 Convex 有限處理授權，用於平台交付、維護/支援/改進、客戶發起的整合及法律義務。這是客戶授予平台的授權，並非轉移資料所有權。

Convex 擁有 Aggregated Data，可用於分析、產品開發和基準比較等合法商業目的。該資料不得識別客戶/使用者、以可識別形式包含其資訊，也不得合理地允許重新識別。

AI 條款禁止在未獲客戶事先書面同意時，使用 Customer Data 訓練/改進 Convex 或第三方基礎模型。相似輸入可能產生相似輸出；不保證結果準確、完整、無錯誤或適合特定用途。

ZDR 標記記錄上次更新時目錄符合零保留的狀態。必須逐一請求啟用路由，沒有合格端點時請求失敗；僅有標記不構成保證。圖像/影片/音訊路由不接受此選項。

隱私、刪除和處理地點

Convex 隱私政策不涵蓋應用程式 Customer Data，後者受客戶協議與應用程式政策規範。對政策涵蓋的資訊，Convex 可能收集 IP/裝置識別碼、約略位置和活動資料，並使用 cookie 與分析工具。

政策涵蓋的資訊可能在包括美國在內的全球各地處理/儲存，並在服務使用期間或為收集目的、交付、爭議、稽核、法律抗辯、商業目的、執行及法律義務而保留；未規定統一固定期間。

依 DPA，Convex 必須在協議到期或終止時刪除 Customer Personal Data。備份/封存副本依其保留時程刪除；法律要求保留的副本須隔離並防止進一步處理，適用法律要求的處理除外。次處理者清單將基礎設施/資料庫服務與所選區域關聯，同時列出美國的支援、分析、計費和 AI 路由，以及德國的社群管理。

Convex 表示客戶程式碼、資料庫、檔案與搜尋索引採用 AES-256 靜態加密，傳輸加密，正式環境存取受限，並符合 SOC 2 Type 2。Convex 稱受 HIPAA 規範的企業簽署其 Business Associate Agreement 後可在平台處理 PHI；這些廠商聲明不能證明每個客戶的應用程式均合規。

FAQ

Q1. 每個 Convex 函式都有即時性和交易保證嗎？

沒有。查詢有快取且可訂閱，變更具交易性；外部 action 不繼承相同保證。

Q2. Free 方案包含 AI Gateway 嗎？

不包含。它要求付費團隊，模型使用另按量計費。自行架設的部署使用自己的供應商憑證。

Q3. 選擇歐洲區域是否代表所有類型資料都留在那裡？

不是。部署基礎設施、隱私政策涵蓋的個人資訊、次處理者和模型路由保留的範圍各不相同。