Windows Copilot API

📌 核心价值：把 Microsoft Copilot 逆向工程成 OpenAI 兼容 API，免 Key 免费用直连 GPT-4 级别模型

7 天 700+ Star，MIT 开源，浏览器登录一次就能让 OpenAI SDK 改一行 base_url 直接跑起来。

---

🚀 什么是 Windows Copilot API？

Windows Copilot API（sums001/Windows-Copilot-API）是一个把微软 Copilot 免费聊天界面反向工程为 OpenAI 兼容 API 的开源项目。它让你用现有的 Microsoft 账号免费调用 GPT-4/GPT-5 级别模型——无需 API Key、无需付费、无需积分。

核心定位：零成本、零代码迁移——改一行 base_url，把 OpenAI SDK 接到 Copilot 上来跑。

---

✨ 核心功能一览

---

🛠️ 5 分钟跑通示例

方式一：直接 Python 库调用

# 克隆项目
git clone https://github.com/sums001/Windows-Copilot-API.git
cd Windows-Copilot-API

# 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate  # macOS/Linux
# 或：venv\Scripts\Activate.ps1  # Windows

# 安装依赖
pip install -r requirements.txt
playwright install chromium  # 一次性安装浏览器

# 登录一次（浏览器自动打开，登录后自动关闭）
python -m copilot login

# 启动服务
python app.py
# -> Copilot OpenAI-compatible API on http://127.0.0.1:8000

方式二：Docker 一键部署

docker compose up --build
# 服务运行在 http://localhost:8000

注意：容器内无 GUI，需先在宿主机完成 python -m copilot login；session/ 目录通过 bind mount 共享。

核心代码示例

Python 库方式（直接调用）：

from copilot import CopilotClient

client = CopilotClient()  # 自动加载已登录的 session

# 单次对话
reply = client.chat("Say hello in one short sentence.")
print(reply.text)

# 多轮对话（传入 conversation_id 维持上下文）
reply2 = client.chat("And now in French?", reply.conversation_id)
print(reply2.text)

# 流式输出
for chunk in client.stream("Tell me a short joke"):
    print(chunk, end="", flush=True)

OpenAI SDK 方式（任意 OpenAI 客户端都能接）：

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8000/v1", api_key="unused")

resp = client.chat.completions.create(
    model="copilot",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

curl 方式：

curl http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Hello!"}]}'

---

🏗️ 架构原理

整套系统由四层组成：

1. 客户端层 — OpenAI SDK、curl、Python 库等任何兼容 OpenAI 协议的客户端
2. FastAPI 服务器层（server/api.py）— 监听 :8000 端口，提供 /v1/chat/completions 和 /v1/models 两个端点
3. Copilot 客户端层（copilot/）— 封装 Playwright 浏览器自动化 + WebSocket 通信
4. 上游服务 — copilot.microsoft.com 的 GPT-4 级别模型，Cloudflare cf_clearance 验证

session/ 目录保存登录态（token.json、profile/、WebSocket 抓包日志），全部本地化，.gitignore 已加保护。

---

📊 与竞品对比

Windows Copilot API 的独特定位：「免费」+「OpenAI 兼容」+「零代码迁移」三合一——市面其他方案要么收费（OpenAI 官方、Azure OpenAI），要么需要本地 GPU（Ollama），要么完全不兼容 OpenAI SDK。

---

📈 性能基准

智能水平：GPQA Diamond 测试

198 道研究生级科学问题（闭卷）：

• Windows Copilot API（基于 Copilot）：40.9%
• 对标：GPT-4 家族级别
• 注意：未达 o1/o3 推理模型水平

并发能力（单账号）

并发数	结果	耗时
1	✅ 全部成功	3.7s
2	✅ 全部成功	4.6s
4	✅ 全部成功	8.3s
8	❌ 1 个失败（HTTP 502）	13.3s

结论：服务会串行化上游调用以避免触发 Copilot 风控。生产环境建议并发 ≤ 4。

速率限制（默认值）

• RATE_LIMIT_RPM=12：每分钟最多 12 次请求
• RATE_LIMIT_BURST=4：瞬时突发最多 4 个
• 12 rpm 是在 Copilot 上游出现 502 错误前的安全值（阈值约 15 rpm）

---

💡 适用场景

场景 1：LangChain/LlamaIndex 学习项目

功能说明：用 OpenAI 兼容的 LangChain 应用零成本验证 prompt engineering 和 Agent 编排。

输入要求：OpenAI SDK 调用 + 任意 prompt

输出效果：GPT-4 级别响应，无需充值 API Key

适用场景：

• 跑通 LangChain ReAct Agent 示例
• LlamaIndex 索引 + RAG demo
• AutoGen 多 Agent 协作实验

---

场景 2：学术研究基准测试

功能说明：用 GPQA、MMLU 等公开基准做论文实验，复现 GPT-4 表现。

输入要求：测试题目 + 答案判分脚本

输出效果：40.9% GPQA Diamond（已含内置脚本 tests/gpqa_bench.py）

适用场景：

• 论文实验章节：低成本跑对照实验
• 复现 OpenAI 闭源模型行为
• 教学演示真实 LLM 能力边界

---

场景 3：企业内部 POC 验证

功能说明：在内网部署，临时演示 API 集成效果，无需走 IT 部门申请 OpenAI 账号。

输入要求：Docker + 一台 Linux 服务器

输出效果：完整 OpenAI 兼容 API，可对接企业现有 SDK

适用场景：

• 客户现场 demo 演示
• 内部工具快速验证可行性
• 临时 debug 工具

---

用户群体总结

• ✅ 个人开发者：学习 OpenAI API、跑 side project、side hustle 验证
• ✅ 学生/学术：跑基准测试、教学演示、论文实验
• ✅ 企业内部：内网 demo、POC 验证、临时工具
• ❌ 不适合：高并发生产环境（≥8 并发会被风控）

---

🔐 Cloudflare 验证机制

Copilot 接口由 Cloudflare 保护，需要 cf_clearance cookie（有效期约 30 分钟）。项目自动处理流程：

1. 登录时：登录流程会自动完成 "verify you're human" 验证
2. 过期时：自动打开浏览器完成验证并重试
3. 服务器端：无法打开浏览器时返回 503（type: "clearance_required"），需在宿主机重新执行 python -m copilot login

💡 提示：住宅 IP 验证最顺利；数据中心 / VPN IP 更容易出现验证框。

故障排查时跑诊断脚本：

python tests/diagnostic.py                # 浏览器抓取 + 报告
python tests/diagnostic.py --report-only  # 无头环境（VPS）使用

---

💰 定价方案

Windows Copilot API 本身完全免费（MIT 协议）。但需要注意：

• 零 API 费用：复用你已有的 Microsoft 账号
• 无日聊天限制：Microsoft 没有日聊天次数限制（但请合理使用避免被封号）
• 云算力费用：自托管时云服务器费用由你自己承担（可跑在 2 核 4G 最小实例）
• 上游账号风险：长期高频使用可能触发 Copilot 风控，需准备多账号轮换

💡 新用户福利：项目本身 MIT 开源商用，登录一次就能永久使用（token 自动续期）

---

🆘 故障排查

症状	根因	修复
HTTP 502	并发过高 / 速率超限	降并发到 1-4，调低 RATE_LIMIT_RPM
503 clearance_required	Cloudflare 验证过期	重新跑 python -m copilot login
Playwright 启动失败	浏览器未安装	跑 playwright install chromium
Token 失效	session 缓存被清	删除 session/ 目录后重新登录
数据中心 IP 验证卡住	Cloudflare 风控	改用住宅 IP，或换网络环境

诊断工具会生成 session/diagnostic_report.txt：

• 自动修复常见的验证码/clearance 问题
• 记录环境、session 形状、协议抓包等（敏感信息已脱敏）
• 可安全分享到 GitHub Issue 用于求助

---

🎯 总结

Windows Copilot API 是 2026 年最有创意的「免费 LLM API」方案之一——用 7 天 700+ Star 的速度验证了社区刚需。它把"OpenAI 生态兼容性"和"零成本"做到了极致，改一行 base_url 就能让现有 OpenAI 应用跑起来。

推荐指数： ⭐⭐⭐⭐（满分 5 星；扣 1 星因单模型 + 并发能力有限）

适合人群：

• 想学习 OpenAI API 但不想充值的开发者
• 需要做 LLM 基准测试的学生 / 研究人员
• 企业内部快速验证 AI 集成的工程师

立即体验：

• GitHub 仓库： sums001/Windows-Copilot-API
• 5 分钟上手：git clone && pip install -r requirements.txt && python -m copilot login && python app.py

---

数据截至 2026-06-25，最新信息请以 GitHub 仓库为准。