dwgx/WindsurfAPI

Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, Anthropic- & Gemini-compatible APIs. Zero-dependency self-hosted reverse proxy for Claude Code, Cline & Cursor. 把 Windsurf/Devin 云端 100+ 模型变成三套兼容 API。

解決的問題

WindsurfAPI 提供了一種存取超過 100 種 AI 模型(包括 Claude、GPT、Gemini、Grok 以及各種開源模型)的方法,透過將 Windsurf(原 Codeium/Devin Desktop)平台的內部協定轉換為標準、相容的 API。這讓使用者無需直接訂閱每個個別的提供商,即可將這些模型整合到預期使用 OpenAI、Anthropic 或 Gemini API 格式的現有 AI 工具與 SDK 中。

工作原理

該專案作為一個 HTTP 代理伺服器運作,將傳入的標準 API 請求(OpenAI、Anthropic、Gemini)轉換為 Windsurf 的內部 gRPC 協定。它與本地 Windsurf Language Server (LS) 二進位檔案通訊,隨後由該檔案將請求轉發至 Windsurf 雲端伺服器。為了管理穩定性與存取權限,它維護了一個具有自動輪轉、速率限制隔離與故障轉移機制的帳戶池。它還會從回應中剝離提供商特定的身分標記,以確保純淨的 API 體驗。

適用對象

  • 開發者:希望在自己的應用程式或腳本中使用高端模型(如 Claude 3.5/4.5 或 GPT-5 變體)的人員。
  • AI Agent 使用者:使用 Claude Code、Cline、Cursor 或 Aider 等工具,並希望將 Windsurf 的模型目錄作為後端的人員。
  • 自託管使用者:正在尋找用於多個 LLM 的統一 API 閘道的人員。

亮點

  • 多 API 相容性:同時支援 OpenAI (/v1/chat/completions)、Anthropic (/v1/messages) 與 Gemini (/v1beta/models/*) 標準。
  • 廣泛的模型支援:可以存取包括 Anthropic、OpenAI、Google 以及各種中國 LLM 在內的主要提供商的 100 多種模型。
  • 零依賴:使用純 Node.js 構建,沒有 npm 執行階段依賴,利用自定義的 protobuf 實作與圖像解碼。
  • 帳戶管理:包含用於 OAuth 登入(Google/GitHub)、帳戶池監控與代理配置的 Web 儀表板。
  • Agent 就緒:專門設計用於傳遞 tool_usetool_result 訊號,使其能夠與 Claude Code 等代理型 CLI 工具協同工作。
  • 資源高效:實作了帶有記憶體防護與閒置 TTL 的 LS 實例池,以防止在低規格 VPS 上出現 OOM (Out of Memory) 錯誤。