https://github.com/guanxiaol/windsurfpoolapi

Multi-account pool proxy for Windsurf — 113+ models (Claude/GPT/Gemini/Grok/Kimi) via OpenAI & Anthropic APIs, image upload, Cursor & Claude Code native / 企业级 Windsurf 多账号池化 API 代理
https://github.com/guanxiaol/windsurfpoolapi

ai-proxy anthropic anthropic-api api claude claude-code codeium cursor gemini gpt language-server llm-proxy multi-account multimodal nodejs openai openai-api pool proxy windsurf

Last synced: 18 days ago
JSON representation

Host: GitHub
URL: https://github.com/guanxiaol/windsurfpoolapi
Owner: guanxiaol
License: mit
Created: 2026-04-20T05:17:34.000Z (25 days ago)
Default Branch: main
Last Pushed: 2026-04-25T15:09:43.000Z (19 days ago)
Last Synced: 2026-04-26T02:03:18.756Z (19 days ago)
Topics: ai-proxy, anthropic, anthropic-api, api, claude, claude-code, codeium, cursor, gemini, gpt, language-server, llm-proxy, multi-account, multimodal, nodejs, openai, openai-api, pool, proxy, windsurf
Language: JavaScript
Homepage: https://guanxiaol.github.io/WindsurfPoolAPI/
Size: 641 KB
Stars: 132
Watchers: 2
Forks: 28
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md

Awesome Lists containing this project

README

          


  

  

  

  

  

  



WindsurfPoolAPI




  Enterprise-grade multi-account pool proxy for Windsurf AI platform.


  Expose 113+ models (Claude / GPT / Gemini / DeepSeek / Grok / Qwen / Kimi / GLM) via standard OpenAI & Anthropic APIs.


  _{企业级 Windsurf 多账号池化 API 代理 —— 113+ 模型，OpenAI / Anthropic 双协议兼容，Cursor / Claude Code 原生支持}





  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) |

| **113+ Models** | Claude Opus 4.7 · GPT-5.4 · Gemini 3.1 · DeepSeek R1 · Grok 3 · Qwen 3 · Kimi K2.5 · GLM-5.1 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 |

| **Image Upload** | Multimodal support — send images via `image_url` blocks (base64 or URL) |

| **Tool Calling** | `` protocol compatible — works with Cursor, Aider, and other AI coding tools |

| **Cursor Compatible** | 80+ model name aliases including Cursor-friendly names without "claude" keyword |

| **Streaming SSE** | OpenAI format with `stream_options.include_usage` support |

| **Zero Dependencies** | Pure Node.js built-in modules, nothing to install |

中文特性列表

- **双协议兼容** — OpenAI + Anthropic 原生端点，无需任何中间件

- **113+ 模型** — 启动时自动拉取 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 / 安装启动

```bash

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

```bash

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=](https://windsurf.com/editor/show-auth-token?workflow=)

```bash

# ✅ 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 兼容

```bash

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 兼容

```bash

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 / 模型使用统计


  



---

## 🤖 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 / 推荐)

```bash

npm install -g pm2

pm2 start src/index.js --name windsurfpool --cwd /path/to/WindsurfPoolAPI

pm2 save && pm2 startup

```

### systemd (Linux)

```ini

# /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

```

```bash

sudo systemctl enable --now windsurfpool

```

### macOS (launchd)

```bash

bash scripts/install-macos.sh

```

### Firewall / 防火墙

```bash

# 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 / 架构

```text

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](https://github.com/dwgx/WindsurfAPI). Special thanks to [@dwgx](https://github.com/dwgx) for the foundational work and open-source contribution.

本项目基于 [dwgx/WindsurfAPI](https://github.com/dwgx/WindsurfAPI) 的初始版本开发，感谢原作者 [@dwgx](https://github.com/dwgx) 的开创性工作和开源贡献。

---

## 📄 License

[MIT](LICENSE)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/guanxiaol/windsurfpoolapi

Awesome Lists containing this project

README

WindsurfPoolAPI