Windsurf API

Windsurf 的 OpenAI / Anthropic 雙相容代理服務。在你的伺服器上無頭運行 80+ AI 模型,透過標準 API 端點對外提供服務。

零依賴 80+ 模型 OpenAI 相容
GitHub 倉庫 部署教學

功能特色

將 Windsurf 的 AI 模型作為 API 服務運行所需的一切

API

OpenAI 相容 API

直接替換 /v1/chat/completions 和 /v1/models,可搭配任何 OpenAI SDK 或用戶端使用。

80+

80+ AI 模型

Claude、GPT、Gemini、DeepSeek、Grok、Qwen、Kimi 及 Windsurf SWE 模型,一個 API 全部存取。

Pool

多帳號池

多個 Windsurf 帳號輪詢負載均衡,自動錯誤追蹤與故障轉移。

UI

管理後台

Web 介面管理帳號、代理配置、即時日誌串流、請求統計與封禁偵測。

SSE

串流支援

完整 SSE 串流輸出,相容 OpenAI 格式。支援串流與非串流兩種模式。

0

零依賴

純 Node.js 實作,僅使用內建模組,無需 npm install。

支援的模型

來自 8+ 個供應商的 80+ 個模型,透過一個 API 統一存取

Claude Anthropic

  • claude-3.5 / 3.7-sonnet
  • claude-4-sonnet / opus
  • claude-4.1-opus
  • claude-4.5-sonnet / haiku / opus
  • claude-sonnet / opus-4.6
  • claude-code

GPT OpenAI

  • gpt-4o免費 / 4o-mini免費
  • gpt-4.1 / mini / nano
  • gpt-5 / 5-mini
  • gpt-5.2 / 5.3 / 5.4
  • o3 / o3-pro / o4-mini

Gemini Google

  • gemini-2.5-pro / flash免費
  • gemini-3.0-pro / flash
  • gemini-3.1-pro

其他 多家

  • deepseek-v3 / r1
  • grok-3 / grok-3-mini
  • qwen-3 / qwen-3-coder
  • kimi-k2 / k2.5
  • swe-1.5 / 1.6
免費帳號可用模型:gpt-4o-mini 和 gemini-2.5-flash。其餘模型需要 Windsurf Pro 訂閱。

部署教學

從零開始在 Linux 伺服器上部署,幾分鐘內完成

安裝 Node.js

需要 Node.js 20 或更高版本。

bash
# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs

# 驗證安裝
node -v   # 應顯示 v20.x 或更高

取得 Language Server

從 Windsurf 的 Linux 版本中提取 language_server_linux_x64 二進位檔。

bash
# 建立目錄並放置二進位檔
mkdir -p /opt/windsurf /opt/windsurf/data/db
cp language_server_linux_x64 /opt/windsurf/
chmod +x /opt/windsurf/language_server_linux_x64

下載專案

bash
git clone https://github.com/guanxiaol/WindsurfAPI.git
cd WindsurfAPI

設定環境變數

建立 .env 檔案,依需求修改設定。

.env
PORT=3003
API_KEY=                          # 留空 = 不驗證 API 密鑰
DEFAULT_MODEL=gpt-4o-mini         # 預設模型
MAX_TOKENS=8192
LOG_LEVEL=info                    # debug / info / warn / error
LS_BINARY_PATH=/opt/windsurf/language_server_linux_x64
LS_PORT=42100
DASHBOARD_PASSWORD=               # 留空 = 後台免密碼

啟動服務

推薦使用 PM2 做程序管理,支援自動重啟和開機自動啟動。

bash
# 安裝 PM2
npm install -g pm2

# 啟動服務
pm2 start src/index.js --name windsurf-api

# 設定開機自動啟動
pm2 save
pm2 startup

新增 Windsurf 帳號

服務啟動後,需要至少新增一個帳號才能使用。Token 從 Windsurf 編輯器登入後取得。

bash
# 使用 Token 新增帳號
curl -X POST http://localhost:3003/auth/login \
  -H "Content-Type: application/json" \
  -d '{"token": "你的-windsurf-token"}'

# 使用 API Key
curl -X POST http://localhost:3003/auth/login \
  -H "Content-Type: application/json" \
  -d '{"api_key": "sk-ws-..."}'

# 批次新增多個帳號
curl -X POST http://localhost:3003/auth/login \
  -H "Content-Type: application/json" \
  -d '{"accounts": [{"token":"t1"},{"token":"t2"}]}'

驗證並使用

bash
# 健康檢查
curl http://localhost:3003/health

# 測試對話
curl http://localhost:3003/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'

# 打開管理後台
# 瀏覽器訪問 http://你的IP:3003/dashboard
重啟注意:不要使用 pm2 restart,會產生殭屍程序。正確方式:pm2 stop && pm2 delete && fuser -k 3003/tcp && pm2 start

管理後台

功能完整的 Web 管理介面,訪問 /dashboard

總覽
運行時間、帳號池狀態、成功率
帳號管理
新增、刪除、停用、標籤編輯
代理配置
全域及個別帳號代理設定
日誌檢視
即時 SSE 串流、級別篩選
請求統計
按模型/帳號指標與圖表
封禁偵測
錯誤模式與帳號健康監控

架構

輕量代理鏈,零外部依賴

用戶端(OpenAI SDK / curl)
|
WindsurfAPI(Node.js,埠號 3003)
|
Language Server(gRPC,埠號 42100)
|
Windsurf 後端