Octri：API 文件產生工具與多語言 SDK 平台

Octri 是以 API 規格為核心的 API 文件產生工具，結合文件網站、客戶端 SDK、MCP 服務與監控，讓提供 API 的團隊能以共同來源維護接入資料。

Octri 到底在做什麼？白話說明

把 API 想成提供訂單查詢或付款功能的服務窗口，規格檔就是描述各個窗口如何使用的說明書。Octri 會把這份說明書整理成開發者能閱讀的網站、程式能安裝的呼叫套件，以及 AI 助手能讀取和使用的工具。

它適合 SaaS、API 供應商與開發者平台團隊，尤其是同時維護不同語言串接的情境。你仍須提供實際運作的 API，並確認產生的描述符合業務規則。四個模組可以依需求使用，不必一次全部啟用。

從規格匯入到第一份可用文件

API Studio 提供端點參考頁、可展開的資料結構、請求範例與搜尋。除了依規格產生的內容，也能加入自己撰寫的 MDX 指南，用來說明登入流程、串接順序或版本遷移。

1. 上傳規格檔，或連結存放規格的 GitHub 儲存庫。
2. 檢查驗證方式、端點名稱、參數與回應結構。
3. 產生文件後直接編輯頁面，補足規格未解釋清楚的操作情境。
4. 在測試環境使用互動控制台執行請求，核對正常及錯誤回應。
5. 設定發布資訊、所需 SDK 語言與套件儲存庫，檢查草稿及差異後再核准發布。

重新產生時，官方說明會保留手動修改過的欄位，並更新未修改的產生內容。

互動請求由讀者的瀏覽器發送，API 的 CORS 設定因此會影響測試。GitHub 規格異動可以觸發重建，但正式 SDK 版本送往套件儲存庫前仍有審核流程。

用同一份規格維護多語言 SDK

SDK Studio 支援 TypeScript、Python、Go、Java、Kotlin、Ruby、PHP、Rust、Swift 與 Dart。你可以調整方法名稱、排除內部端點及設定語言選項，再產生客戶端套件。

這對需要服務網站、伺服器與行動應用開發者的團隊特別實用。不過，平台支援十種語言，與目前方案能啟用多少種語言是兩回事。自訂 SDK 程式碼列在 Growth 以上方案，產出後也應測試驗證及特殊資料結構。

免費額度與付費門檻

截至 2026 年 10 月 6 日，官網美元月付價格如下；付費方案未含稅，並非新臺幣報價：

• Free：1 個專案、1 種 SDK 語言、50 個端點、每月 100 MB 監控接收量，以及一次性 100 點 AI 額度。
• Starter：每月 49 美元，包含 2 種 SDK 語言。
• Growth：每月 99 美元，包含 4 種語言、版本管理及自訂程式碼與元件。
• Business：每月 249 美元，包含全部 10 種語言與白標功能。
• Enterprise：另行報價；可在自有基礎設施執行產生器與文件渲染器。

每次產生一個端點的說明或取得一次文件問答，會使用 1 點 AI 額度。手動編輯、SDK 建置和文件託管不扣這類點數。完整限制與加購條件請查看官方方案比較。

MCP 讓 AI 助手取得實際介面資訊

Octri MCP 提供 7 個文件工具，也能把選定端點提供為可執行工具。Claude、Cursor 等客戶端因此可以讀取已發布資料，並依實際參數呼叫 API。

只有專案 ID 時可使用文件工具；執行 API 需要對應憑證，官方說明憑證保留在執行 MCP 的機器上。應明確選擇測試或正式環境、憑證權限及排除端點，因為工具呼叫可能修改真實資料。

監控與資料處理需要分開理解

監控預設關閉，可在啟用後透過產生的 SDK 或後端套件回報日誌、錯誤與追蹤資訊，並提供可用性檢查和告警。官方說明會在客戶端與接收階段遮蔽敏感資訊，團隊仍需確認自己傳送的內容。

依隱私政策，產生文件會將相關規格交給模型服務，問答會送出問題及匹配段落，搜尋則涉及文件向量化。官方承諾不以這些內容訓練模型，但處理並非完全在本機完成。

常見問題

免費版可以使用自己的網域嗎？

可以，自訂網域與 GitHub 同步列在 Free 方案內。仍須遵守專案、端點與 SDK 語言數量限制。

可以匯入哪些 API 規格？

官方列出 OpenAPI 3.0/3.1、Swagger 2.0、Postman 與 AsyncAPI，接受 JSON 或 YAML。匯入後應再次核對資料模型。

AI 點數用完後，文件還能看嗎？

可以。AI 產生與文件問答會停止，但已發布文件、SDK 建置與監控仍可運作。免費點數不會每月自動補回。

官方資源與開發者支援

• Octri 技術文件：設定與各語言 SDK 指南。
• Octri GitHub：公開套件與 SDK 問題回報。
• 產品及帳務支援：官方聯絡與疑難排解入口。