Windows-Copilot-API 是一个用 Python 实现的非官方 Microsoft Copilot 逆向封装项目，可将个人 Microsoft Copilot 网页聊天能力转换为本地 OpenAI 兼容 API。开发者登录自己的 Microsoft 账号后，可以通过 Python SDK、HTTP REST 接口或 OpenAI SDK 调用本地服务，实现聊天、流式输出和多轮对话。项目强调无需 OpenAI API Key、无需计费，但本质上依赖个人 Copilot Web 会话，适合个人开发、原型验证和低并发场景。
适用领域
大语言模型 API / AI 应用开发 / OpenAI 兼容接口 / Microsoft Copilot 自动化 / Python 后端服务 / 本地 LLM 网关 / AI Agent 工具集成
配置难度
中等。对于熟悉 Python、虚拟环境、命令行和 OpenAI SDK 的开发者，上手较快；但如果要在服务器、Docker、代理网络或自动化环境中稳定运行，需要理解 Playwright 登录、session 持久化、限流、并发锁、Cloudflare 验证和错误重试机制。
商业价值
该项目的商业价值主要体现在低成本原型验证、个人工具开发和 OpenAI 兼容生态适配上。它可以帮助团队在早期阶段快速验证 AI 功能、降低测试成本，并复用现有 OpenAI SDK 接入方式。但由于其非官方、逆向、低并发、合规不确定和稳定性不可控，不建议作为正式商业产品的核心 LLM 服务。更适合内部实验、学习研究、个人自动化和 Demo 场景，而不是面向客户的生产级 AI 网关。
01
技术亮点
- 提供 OpenAI 兼容接口，可较容易接入已有 OpenAI SDK 或生态工具。
- 支持 Python 库调用和本地 REST API 两种使用方式。
- 支持流式输出和多轮对话。
- 无需 OpenAI API Key，也没有传统 API 计费流程，适合个人低成本实验。
- 登录一次后会复用 session，并尝试自动刷新。
- 提供 Docker Compose、示例代码、压力测试和限流机制。
- 项目结构清晰，核心库、FastAPI 服务、示例和测试脚本分离。
- MIT 许可证，对二次开发较友好。
02
目标用户
- 希望低成本调用类 GPT-4 能力的个人开发者
- 需要 OpenAI 兼容接口进行本地测试的 AI 应用开发者
- 想把 Microsoft Copilot 接入自己脚本或工具链的 Python 开发者
- 正在构建 AI Agent、聊天机器人、自动化助手的开发者
- 希望在无 OpenAI API Key 或预算有限情况下做原型验证的团队
- 学习 FastAPI、Playwright、LLM API 封装的开发者
03
配置要求
- 需要 Python 3.9+。
- 需要一个可正常使用 Microsoft Copilot 的 Microsoft 账号。
- 首次使用需要图形浏览器登录，依赖 Playwright 和 Chromium。
- 登录后的 cookies/token 保存在本地 session/ 目录，不应提交到 Git 或共享给他人。
- 默认本地 API 地址为 http://127.0.0.1:8000，可通过 HOST 和 PORT 环境变量修改。
- 速率限制可通过 RATE_LIMIT_RPM 和 RATE_LIMIT_BURST 配置，默认 RATE_LIMIT_RPM=12，RATE_LIMIT_BURST=4。
- 如果部署在 VPS 或数据中心 IP，可能需要手动通过 Cloudflare 人机验证以获得 cf_clearance cookie。
- Docker 模式下仍建议先在宿主机完成登录，因为容器内通常无法完成可视化登录流程。
- 项目只暴露单一模型名 copilot，不支持像 OpenAI 那样选择具体模型。
04
适用场景
- 将 Copilot 作为本地 OpenAI-compatible API 使用，替换 OpenAI base_url
- 在 Python 脚本中直接调用 CopilotClient 进行问答
- 为 LangChain、LlamaIndex、AutoGen、OpenAI SDK 等工具提供本地兼容接口
- 构建个人聊天机器人、命令行助手或自动化问答工具
- 进行低频率的文本生成、总结、翻译、代码解释等任务
- 在没有 OpenAI API Key 或不希望产生 API 费用时做 Demo 和 PoC
- 测试流式输出、多轮对话和 conversation_id 管理
05
部署与配置
- 安装 Python 3.9 或更高版本。
- 克隆仓库：git clone https://github.com/sums001/Windows-Copilot-API.git && cd Windows-Copilot-API
- 创建虚拟环境：macOS/Linux 使用 python3 -m venv venv && source venv/bin/activate；Windows PowerShell 使用 python -m venv venv && venv\Scripts\Activate.ps1
- 安装依赖：pip install -r requirements.txt
- 安装 Playwright Chromium 浏览器：playwright install chromium
- 首次登录 Microsoft 账号：python -m copilot login，浏览器会打开并要求登录 Copilot。
- 直接作为 Python 库使用：from copilot import CopilotClient，然后调用 client.chat() 或 client.stream()。
- 或启动 OpenAI 兼容服务：python app.py，默认监听 http://127.0.0.1:8000/v1。
- 在 OpenAI SDK 中设置 base_url='http://localhost:8000/v1'，api_key 可填任意值。
- 可选 Docker 部署：先在宿主机完成登录生成 session/，再运行 docker compose up --build。
06
风险与注意事项
- 这是非官方逆向项目，不受 Microsoft 支持，随时可能因 Copilot 网页端协议变化而失效。
- 使用方式可能违反或触及 Microsoft Copilot 服务条款，商业化或大规模使用存在合规风险。
- 依赖个人 Microsoft 账号和浏览器 session，账号安全和 cookie 泄露风险需要重点关注。
- 并发能力很弱，单账号请求会被串行化，官方 README 也提示 1 到 4 个并发以内更安全。
- 高频调用可能触发上游 502、风控、人机验证甚至账号限制。
- 不适合生产级、高可用、高吞吐业务场景。
- 模型能力、上下文长度、可用性和返回质量不可控，无法像正式 API 那样获得 SLA。
- 在 VPS、服务器或数据中心网络环境下可能遇到 Cloudflare 验证或连接挂起问题。
- 项目声称可访问 GPT-4/GPT-5 类模型，但实际 Copilot 后端模型不可选择、不可验证，README 中也说明只暴露单一 copilot 模型。
- 如果将本地服务暴露到公网且不加认证，可能导致他人滥用你的 Microsoft Copilot 会话。
2026-06-23
第18名
新收录 · github_search
