不管你手上的客戶端走 OpenAI 還是 Anthropic 協定,指向同一個 Windsurf API 實例就能用。
$ curl http://localhost:3003/v1/chat/completions \ -H "Authorization: Bearer sk-ws-demo" \ -d '{ "model": "gpt-5.2", "messages": [ {"role":"user","content":"hello"} ], "stream": true }' # → Server-Sent Events (OpenAI chunk 格式)
$ curl http://localhost:3003/v1/messages \ -H "x-api-key: sk-ws-demo" \ -d '{ "model": "claude-opus-4.6", "messages": [ {"role":"user","content":"hello"} ], "stream": true }' # → SSE (Anthropic message_delta 格式)
/v1/messages,Cursor/OpenAI SDK 吃 /v1/chat/completions,互不干擾。
從 Claude Opus 到 GPT-5、從 Gemini 3 到 DeepSeek R1,9 個供應商的模型統一接入。
gpt-4o-mini 與 gemini-2.5-flash。其餘模型需 Windsurf Pro 訂閱。/v1/models 會自動從雲端發現新模型。
請求進來後經過協定翻譯、帳號池選號、語言伺服器轉 gRPC,最後到 Windsurf 雲端。
訪問 /dashboard,暗色 Web 介面。日誌即時串流、帳號一鍵登入、模型黑白名單、封禁偵測。
運行時間、帳號池狀態、分模型成功率
Email/密碼直接註冊,自動取得 Token
新增、刪除、停用、餘額 Credits 查詢
全域與帳號層的模型白/黑名單
全域及個別帳號 HTTP/SOCKS5 代理
即時 SSE 串流,級別篩選,關鍵字高亮
按模型/帳號維度的指標與圖表
錯誤模式偵測,帳號健康自動監控
一鍵 git pull + PM2 重啟服務
Contributors 列表
兩種方式任選。
$ curl -fsSL https://deb.nodesource.com/setup_20.x | bash - $ apt install -y nodejs
$ git clone https://github.com/dwgx/WindsurfAPI.git $ cd WindsurfAPI $ bash install-ls.sh
.envPORT=3003 API_KEY= # 留空 = 不驗證 DEFAULT_MODEL=gpt-4o-mini LS_BINARY_PATH=/opt/windsurf/language_server_linux_x64 DASHBOARD_PASSWORD= # 留空 = 後台免密碼
$ npm install -g pm2 $ pm2 start src/index.js --name windsurf-api $ pm2 save && pm2 startup
bash update.sh$ git clone https://github.com/dwgx/WindsurfAPI.git $ cd WindsurfAPI $ cp .env.example .env
$ docker compose up -d --build $ docker compose logs -f
.docker-data/data 持久化帳號/配置,.docker-data/opt/windsurf 放 LS binary。容器首次啟動會自動下載。
改 BASE_URL,塞 API KEY,完事。
→ /v1/messages · Anthropic 協定
export ANTHROPIC_BASE_URL="http://YOUR_IP:3003" export ANTHROPIC_API_KEY="sk-ws-your-key" claude
→ /v1/chat/completions · OpenAI 協定
# Settings → Models → Custom OpenAI Base URL: http://YOUR_IP:3003/v1 API Key: sk-ws-your-key Model: claude-opus-4.6
→ Anthropic 或 OpenAI provider 皆可
# Provider: OpenAI Compatible Base URL: http://YOUR_IP:3003/v1 API Key: sk-ws-your-key
→ /v1/chat/completions
from openai import OpenAI client = OpenAI( base_url="http://YOUR_IP:3003/v1", api_key="sk-ws-your-key", )
gpt-4o-mini 和 gemini-2.5-flash。Claude、GPT-5 全系、Gemini 3 等都需要 Windsurf Pro 訂閱。後台會自動偵測並標記每個帳號的 tier。language_server_linux_x64),所以聊天功能僅限 Linux。Windows 建議放 WSL2 或純 Linux VM。~/Library/Application Support/Windsurf/.../language_server_macos_arm~/.windsurf/bin/language_server_linux_x64/v1/models 會自動從雲端 discover 最新目錄。/v1/messages 和 /v1/chat/completions。