poe-api-wrapper

环境要求

• Python 环境（使用 [proxy] 版本需 Python 3.9+）
• pip 包管理器
• 一个 Poe.com 账号，并从中获取 p-b 与 p-lat Cookie
• （可选）formkey，部分场景需要
• （可选）git，用于克隆仓库运行 OpenAI 代理或测试

安装与启动步骤

1. 1安装核心库

   用 pip 安装并升级 poe-api-wrapper，这是使用所有功能的前提。

   pip install -U poe-api-wrapper

   复制

2. 2安装代理支持版

   需要自动代理功能时改用带 proxy 扩展的安装方式，该版本要求 Python 3.9 及以上。

   pip install -U 'poe-api-wrapper[proxy]'

   复制

3. 3获取账号 Token

   从浏览器中取出 Poe 的 p-b 与 p-lat Cookie 作为 tokens，formkey 为可选项，具体步骤见 README 文档。

4. 4异步客户端发消息

   用 tokens 创建 AsyncPoeApi 客户端，向 gpt3_5 机器人发送消息并流式打印回复内容。

   from poe_api_wrapper import AsyncPoeApi
   import asyncio
   tokens = {
       'p-b': 'p-b cookie here',
       'p-lat': 'p-lat cookie here',
   }
   
   async def main():
       client = await AsyncPoeApi(tokens=tokens).create()
       message = "Explain quantum computing in simple terms"
       async for chunk in client.send_message(bot="gpt3_5", message=message):
           print(chunk["response"], end='', flush=True)
   
   asyncio.run(main())

   复制

5. 5命令行界面使用

   库自带 CLI，用 -b 传 p-b、-lat 传 p-lat、-f 传 formkey；输入 poe -h 可查看全部参数。

   poe -b P-B_HERE -lat P-LAT_HERE -f FORMKEY_HERE

   复制

6. 6启动 OpenAI 代理

   安装 llm 扩展后克隆仓库，进入 openai 目录修改 secrets.json 填入自己的 tokens，再启动 FastAPI 服务。

   pip install -U 'poe-api-wrapper[llm]'
   git clone https://github.com/snowby666/poe-api-wrapper.git
   cd poe-api-wrapper\poe_api_wrapper\openai
   python api.py

   复制

7. 7运行测试用例

   需要参与调试时，克隆仓库并以可编辑方式安装测试依赖，再执行 tox 跑测试。

   git clone https://github.com/snowby666/poe-api-wrapper.git
   cd poe-api-wrapper
   python -m pip install -e .[tests]
   tox

   复制

关键配置

如何确认成功

运行 python api.py 后本地 8000 端口会启动 OpenAI 兼容服务；异步示例中能看到流式打印的回复内容即表示调用成功。

常见问题

注意事项

• 该项目已不再积极维护，README 推荐使用 Poe 官方 API。
• 它通过模拟 Poe 网页端请求实现，存在被官方封禁或策略变更的风险。
• p-b、p-lat 等 Cookie 属于敏感凭据，不要提交到代码仓库或公开分享。
• OpenAI 代理示例中的目录路径按 README 原文为 Windows 反斜杠写法，其他系统需自行换算。