Windows Copilot API

对于开发者和个人用户而言，获取高质量的大语言模型（LLM）API 往往伴随着高昂的成本或复杂的密钥管理。Windows Copilot API 是一个非官方的开源项目，它通过逆向工程 Microsoft Copilot 的网页端，将其免费的聊天服务转换为一个标准的、OpenAI 兼容的 REST API。

这意味着你可以直接使用自己的 Microsoft 账户，无需支付任何费用、无需申请 API Key、无需担心积分耗尽，即可在代码中调用强大的 GPT-4 或 GPT-5 模型。

核心亮点：免费、兼容、无缝集成

• 完全免费：利用你已有的 Microsoft 账户登录即可使用，绕过传统 API 的计费模式。
• OpenAI 兼容：提供标准的 /v1/chat/completions 接口。任何支持 OpenAI SDK 的工具（如 LangChain、LlamaIndex、各种 AI 客户端）只需将 base_url 指向本地服务器，即可无缝切换，无需修改代码逻辑。
• 跨平台支持：基于 Python 和 Playwright 构建，可在 Windows、macOS 和 Linux 上运行。
• 会话持久化：只需在浏览器中登录一次，会话令牌会自动保存并刷新，后续调用无需人工干预。
• 突破地域限制：即使在某些地区（如印度）匿名 Copilot 被屏蔽，只要你能通过浏览器登录 Microsoft 账户，该工具即可正常工作。

技术原理

该项目使用 Playwright 自动化浏览器操作，模拟真实用户与 copilot.microsoft.com 的交互。它拦截并复用登录后的会话状态，将用户的文本请求发送给微软后端，并将返回的流式响应解析为标准 JSON 格式。

⚠️ 免责声明：这是一个非官方项目，与 Microsoft 无关。它自动化了消费者级的网页体验，请负责任地使用，并遵守 Microsoft 的服务条款。建议仅用于个人学习、研究或非高频的生产力辅助，避免滥用导致账户受限。

快速开始：2 分钟部署

1. 环境准备

确保已安装 Python 3.9+。

# 克隆项目
git clone <your-repo-url>
cd Windows-Copilot-API

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # macOS/Linux
# venv\Scripts\Activate.ps1  # Windows PowerShell

# 安装依赖
pip install -r requirements.txt
playwright install chromium

2. 登录账户

运行以下命令，浏览器会自动打开，请使用你的 Microsoft 账户登录 Copilot。

python -m copilot login

登录后，会话信息会保存在 session/ 目录下（该目录已被 git 忽略，确保隐私安全）。

使用方式

方式一：作为 Python 库直接调用

适合直接在 Python 脚本中使用，支持多轮对话和流式输出。

from copilot import CopilotClient

client = CopilotClient()

# 简单对话
reply = client.chat("用一句简短的话说你好。")
print(reply.text)

# 多轮对话：传入 conversation_id
reply2 = client.chat("现在用法语说一遍？", reply.conversation_id)
print(reply2.text)

# 流式输出
for chunk in client.stream("讲个小笑话"):
    print(chunk, end="", flush=True)

方式二：启动本地 OpenAI 兼容服务器

适合配合其他支持 OpenAI 协议的工具使用。

python app.py
# 服务启动在 http://127.0.0.1:8000

使用 OpenAI SDK 调用：

from openai import OpenAI

# base_url 指向本地，api_key 可随意填写（会被忽略）
client = OpenAI(base_url="http://localhost:8000/v1", api_key="unused")

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

使用 cURL 测试：

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

方式三：Docker 部署

如果你更喜欢容器化部署，可以先在主机上完成登录步骤，然后挂载 session/ 目录运行 Docker。

docker compose up --build
# API 将在 http://localhost:8000 可用

适用场景

• 个人开发者：为小型应用、Bot 或脚本提供免费且高质量的 LLM 支持。
• 学习与实验：在不产生费用的情况下，测试 Prompt Engineering 或 RAG 流程。
• 替代方案：当官方 API 配额不足或网络受限时，作为一个临时的备用通道。

Windows Copilot API 巧妙地利用了现有服务的冗余能力，为开发者打开了一扇通往免费高级 AI 模型的大门。虽然它依赖于非官方的逆向工程手段，但在个人使用和轻量级场景下，其便捷性和零成本优势无可比拟。