WindsurfPoolAPI

Enterprise-grade multi-account pool proxy for Windsurf AI platform.
Expose 87+ models (Claude / GPT / Gemini / DeepSeek / Grok / Qwen) via standard OpenAI & Anthropic APIs.
_{企业级 Windsurf 多账号池化 API 代理 —— 87+ 模型，OpenAI / Anthropic 双协议兼容}

Quick Start · Features · Dashboard · API Reference · Deployment · FAQ

⚠️ Disclaimer / 声明

This project is for personal learning, research, and self-hosting only. Commercial use, resale, paid deployment, or repackaging as a service without written authorization is strictly prohibited.

本项目仅供个人学习、研究、自用。未经作者书面授权，禁止任何商业用途、付费代部署、中转转售或包装成服务对外销售。

✨ Features / 核心特性

Feature	Description
Dual Protocol	`/v1/chat/completions` (OpenAI) + `/v1/messages` (Anthropic native)
87+ Models	Claude 4.7 · GPT-5.4 · Gemini 3.1 · DeepSeek R1 · Grok 3 · Qwen 3 · Kimi K2.5 and more
Multi-Account Pool	Capacity-based load balancing, automatic failover, per-model rate-limit isolation
Token & Credit Analytics	Per-API × per-model aggregation down to individual request level
Admin Dashboard	Full-featured SPA: account management, proxy config, real-time logs, usage charts
Batch Operations	Select multiple accounts, enable/disable in one click
OAuth Login	Google / GitHub Firebase OAuth + manual token refresh
Dynamic Stall Detection	Input-length-aware timeout (30s–90s) prevents false positives on large contexts
Persistent State	All settings, account status, tokens survive restarts
Tool Calling	`<tool_call>` protocol compatible — works with Cursor, Aider, and other AI coding tools
Streaming SSE	OpenAI format with `stream_options.include_usage` support
Zero Dependencies	Pure Node.js built-in modules, nothing to install

中文特性列表

双协议兼容 — OpenAI + Anthropic 原生端点，无需任何中间件
87+ 模型 — 启动时自动拉取 Windsurf 最新 catalog，实时更新
多账号池 — 按剩余容量均衡分配，自动故障转移，per-model 限速隔离
Token + Credit 精细统计 — 按 API × 模型分层聚合，精确到单次请求
Dashboard 管理后台 — 账号管理、代理配置、实时日志、使用图表、封禁侦测
批量操作 — 一键多选账号批量启用/停用
OAuth 登录 — 支持 Google/GitHub Firebase OAuth 登录
动态超时检测 — 根据输入长度自适应超时阈值（30s~90s），大上下文不误判
全持久化 — 所有设置、账号状态、Token 均持久化存储，重启不丢失
零依赖 — 纯 Node.js 内置模块，开箱即用

🚀 Quick Start / 快速开始

Prerequisites / 前置条件

Node.js ≥ 20
Windsurf Language Server binary (language_server_linux_x64 or language_server_darwin_arm64)
At least one Windsurf account (Free tier supports limited models)

Install & Run / 安装启动

git clone https://github.com/guanxiaol/WindsurfPoolAPI.git
cd WindsurfPoolAPI

# Place Language Server binary / 放置 Language Server 二进制
sudo mkdir -p /opt/windsurf
sudo cp /path/to/language_server_linux_x64 /opt/windsurf/
sudo chmod +x /opt/windsurf/language_server_linux_x64

# Optional: configure / 可选配置
cp .env.example .env    # Edit API_KEY, DASHBOARD_PASSWORD, etc.

# Start / 启动
node src/index.js

macOS — Run bash scripts/install-macos.sh for auto-start on login.

Windows — Run scripts\install-windows.bat for guided installation.

Dashboard: http://localhost:3003/dashboard

Docker

docker compose up -d --build

Mount the LS binary at /opt/windsurf/ on the host before starting.

🔑 Account Management / 账号管理

⚠️ Always use Token login! / 必须使用 Token 方式登录！

Windsurf has a known bug where email/password login may route requests to the wrong account.

Windsurf 官方存在 bug：邮箱/密码登录可能导致请求路由到错误账号。

Get your token / 获取 Token：https://windsurf.com/editor/show-auth-token?workflow=

# ✅ Add account via Token (recommended / 推荐)
curl -X POST http://localhost:3003/auth/login \
  -H "Content-Type: application/json" \
  -d '{"token": "your-windsurf-token"}'

# Batch add / 批量添加
curl -X POST http://localhost:3003/auth/login \
  -H "Content-Type: application/json" \
  -d '{"accounts": [{"token": "t1"}, {"token": "t2"}]}'

# List accounts / 列出账号
curl http://localhost:3003/auth/accounts

# Remove / 删除
curl -X DELETE http://localhost:3003/auth/accounts/{id}

📡 API Reference / 接口文档

OpenAI Compatible / OpenAI 兼容

curl http://localhost:3003/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

Anthropic Compatible / Anthropic 兼容

curl http://localhost:3003/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: sk-your-api-key" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Environment Variables / 环境变量

Variable	Default	Description
`PORT`	`3003`	HTTP server port
`API_KEY`	(empty)	Auth key for `/v1/*` endpoints. Empty = open access
`DASHBOARD_PASSWORD`	(empty)	Dashboard admin password
`DEFAULT_MODEL`	`claude-4.5-sonnet-thinking`	Default model when none specified
`MAX_TOKENS`	`8192`	Default max output tokens
`LOG_LEVEL`	`info`	`debug` / `info` / `warn` / `error`
`LS_BINARY_PATH`	`/opt/windsurf/language_server_linux_x64`	Language Server path
`LS_PORT`	`42100`	Language Server gRPC port

Dashboard API

All endpoints require X-Dashboard-Password header.

Method	Path	Description
`GET`	`/dashboard/api/overview`	System overview
`GET`	`/dashboard/api/accounts`	List all accounts
`POST`	`/dashboard/api/accounts/batch-status`	Batch enable/disable accounts
`POST`	`/dashboard/api/oauth-login`	OAuth login (Google/GitHub)
`POST`	`/dashboard/api/accounts/:id/refresh-token`	Refresh Firebase token
`POST`	`/dashboard/api/accounts/:id/rate-limit`	Check account capacity
`GET`	`/dashboard/api/usage`	Full usage statistics
`GET`	`/dashboard/api/usage/export`	Export stats as JSON
`POST`	`/dashboard/api/usage/import`	Import stats (auto-dedup)
`GET`	`/dashboard/api/logs/stream`	Real-time SSE log stream

🖥 Dashboard / 管理后台

Access at http://localhost:3003/dashboard

Panel	Description
Overview	Runtime stats, account pool health, success rate
Login	Windsurf token/email login, OAuth
Accounts	Add/remove, batch enable/disable, per-account proxy, quota display
Models	Global allow/blocklist, per-account model restrictions
Proxy	Global + per-account HTTP/SOCKS5 proxy
Logs	Real-time SSE log stream with level filtering
Analytics	Token/Credit charts, 14-day trends, 24h distribution, request details
Detection	Error pattern monitoring, account health
Experimental	Cascade session reuse, model identity masking, preflight rate-limit

Screenshots / 界面预览

Account Pool — Multi-account quota monitoring / 多账号额度监控

Analytics — Token & Credit usage charts / 统计分析面板

Model Stats — Per-model request breakdown / 模型使用统计

Experimental — Cascade reuse & model identity injection / 实验性功能

🤖 Supported Models / 支持的模型

Claude (Anthropic)

claude-3.5-sonnet · claude-3.7-sonnet[-thinking] · claude-4-sonnet[-thinking] · claude-4-opus[-thinking] · claude-4.1-opus[-thinking] · claude-4.5-sonnet[-thinking] · claude-4.5-haiku · claude-4.5-opus[-thinking] · claude-sonnet-4.6[-thinking][-1m] · claude-opus-4.6[-thinking] · claude-opus-4.7-{low,medium,high,xhigh,max}

GPT (OpenAI)

gpt-4o · gpt-4o-mini · gpt-4.1[-mini/nano] · gpt-5[-mini] · gpt-5.2[-low/medium/high] · gpt-5.4[-low/medium/high/xhigh] · gpt-5.3-codex · o3[-mini/high/pro] · o4-mini

Gemini (Google)

gemini-2.5-pro · gemini-2.5-flash · gemini-3.0-pro · gemini-3.0-flash · gemini-3.1-pro[-low/high]

Others / 其他

deepseek-v3 · deepseek-r1 · grok-3[-mini] · grok-code-fast-1 · qwen-3 · qwen-3-coder · kimi-k2 · kimi-k2.5 · swe-1.5[-thinking] · swe-1.6-fast · arena-fast · arena-smart

Model catalog is auto-synced from Windsurf cloud on startup. Free accounts: gpt-4o-mini and gemini-2.5-flash only.

启动时自动从 Windsurf 云端拉取最新模型列表。免费账号仅可用 gpt-4o-mini 和 gemini-2.5-flash。

🚢 Deployment / 部署指南

PM2 (Recommended / 推荐)

npm install -g pm2
pm2 start src/index.js --name windsurfpool --cwd /path/to/WindsurfPoolAPI
pm2 save && pm2 startup

systemd (Linux)

# /etc/systemd/system/windsurfpool.service
[Unit]
Description=WindsurfPoolAPI
After=network.target

[Service]
Type=simple
User=windsurf
WorkingDirectory=/opt/WindsurfPoolAPI
ExecStart=/usr/bin/node src/index.js
Restart=on-failure
RestartSec=5
Environment=PORT=3003

[Install]
WantedBy=multi-user.target

sudo systemctl enable --now windsurfpool

macOS (launchd)

bash scripts/install-macos.sh

Firewall / 防火墙

# Ubuntu
sudo ufw allow 3003/tcp

# CentOS
sudo firewall-cmd --add-port=3003/tcp --permanent && sudo firewall-cmd --reload

Cloud servers: remember to open port 3003 in your security group.

云服务器记得在安全组中开放 3003 端口。

🏗 Architecture / 架构

Client (OpenAI SDK / Anthropic SDK / curl / Cursor / Aider)
   │
   ▼
WindsurfPoolAPI  (Node.js HTTP, :3003)
   ├── /v1/chat/completions    (OpenAI format)
   ├── /v1/messages            (Anthropic format)
   ├── /dashboard/api/*        (Admin API)
   └── /dashboard              (Admin SPA)
   │
   ▼
Language Server Pool  (gRPC-over-HTTP/2, :42100+)
   │
   ▼
Windsurf Cloud  (server.self-serve.windsurf.com)

See ARCHITECTURE.md for module-level details.

❓ FAQ / 常见问题

Q: LS binary not found on startup? A: Ensure the binary exists at /opt/windsurf/language_server_linux_x64 (or set LS_BINARY_PATH).

Q: No accounts available? A: Add at least one account via Dashboard or POST /auth/login.

Q: permission_denied for all accounts? A: Free accounts only support gpt-4o-mini and gemini-2.5-flash. Other models require Windsurf Pro.

Q: How to migrate stats between servers? A: Export: GET /dashboard/api/usage/export → Import: POST /dashboard/api/usage/import (auto-dedup).

Q: How to update models? A: Models auto-sync on startup. Restart the service to refresh.

🤝 Contributing

See CONTRIBUTING.md. Issues and PRs are welcome.

🙏 Acknowledgements / 致谢

This project is built upon dwgx/WindsurfAPI. Special thanks to @dwgx for the foundational work and open-source contribution.

本项目基于 dwgx/WindsurfAPI 的初始版本开发，感谢原作者 @dwgx 的开创性工作和开源贡献。

📄 License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
.github/workflows		.github/workflows
docs		docs
examples		examples
scripts		scripts
src		src
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
ARCHITECTURE.md		ARCHITECTURE.md
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
package.json		package.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

WindsurfPoolAPI

⚠️ Disclaimer / 声明

✨ Features / 核心特性

🚀 Quick Start / 快速开始

Prerequisites / 前置条件

Install & Run / 安装启动

Docker

🔑 Account Management / 账号管理

📡 API Reference / 接口文档

OpenAI Compatible / OpenAI 兼容

Anthropic Compatible / Anthropic 兼容

Environment Variables / 环境变量

Dashboard API

🖥 Dashboard / 管理后台

Screenshots / 界面预览

🤖 Supported Models / 支持的模型

🚢 Deployment / 部署指南

PM2 (Recommended / 推荐)

systemd (Linux)

macOS (launchd)

Firewall / 防火墙

🏗 Architecture / 架构

❓ FAQ / 常见问题

🤝 Contributing

🙏 Acknowledgements / 致谢

📄 License

About

Uh oh!

Releases 3

Packages

Uh oh!

Contributors 1

Languages

Folders and files

Latest commit

History

Repository files navigation

WindsurfPoolAPI

⚠️ Disclaimer / 声明

✨ Features / 核心特性

🚀 Quick Start / 快速开始

Prerequisites / 前置条件

Install & Run / 安装启动

Docker

🔑 Account Management / 账号管理

📡 API Reference / 接口文档

OpenAI Compatible / OpenAI 兼容

Anthropic Compatible / Anthropic 兼容

Environment Variables / 环境变量

Dashboard API

🖥 Dashboard / 管理后台

Screenshots / 界面预览

🤖 Supported Models / 支持的模型

🚢 Deployment / 部署指南

PM2 (Recommended / 推荐)

systemd (Linux)

macOS (launchd)

Firewall / 防火墙

🏗 Architecture / 架构

❓ FAQ / 常见问题

🤝 Contributing

🙏 Acknowledgements / 致谢

📄 License

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Uh oh!

Contributors 1

Languages

Packages