Pplx2Api

pplx2api 对外提供OpenAi 兼容接口，支持识图，思考，搜索，文件上传，账户轮询，重试，模型监控……

使用条件

要求家庭宽带或者优质IP

连接优质网络，开启浏览器隐私模式，访问 https://www.perplexity.ai/rest/sse/perplexity_ask

如果遇到cloudflare 的人机验证，则网络暂不支持使用本项目

PS : 不要使用服务器直接curl ，这并不能检验网络条件是否可用

---

✨ 特性

• 🖼️ 图像识别 - 发送图像给Ai进行分析
• 📝 隐私模式 - 对话不保存在官网，可选择关闭
• 🌊 流式响应 - 获取实时流式输出
• 📁 文件上传支持 - 上传长文本内容
• 🧠 思考过程 - 访问思考模型的逐步推理，自动输出<think>标签
• 🔄 聊天历史管理 - 控制对话上下文长度，超出将上传为文件
• 🌐 代理支持 - 通过您首选的代理路由请求
• 🔐 API密钥认证 - 保护您的API端点
• 🔍 搜索模式- 访问 -search 结尾的模型，连接网络且返回搜索内容
• 📊 模型监控 - 跟踪响应的实际模型，如果模型不一致会返回实际使用的模型
• 🔄 自动刷新 每天自动刷新cookie，持续可用

📋 前提条件

• Go 1.23+（从源代码构建）
• Docker（用于容器化部署）

✨ 关于环境变量SESSIONS

为https://www.perplexity.ai/ 官网cookie中 __Secure-next-auth.session-token 的值

环境变量SESSIONS可以设置多个账户轮询或重试，使用英文逗号分割即可

当前支持模型

claude-3.7-sonnet

claude-3.7-sonnet-think

deepseek-r1

gpt-4.5

o3-mini

gpt-4o

gemini-2.0-flash

grok-2

……

（以及对应模型的-search版本）

🚀 部署选项

Docker

docker run -d \
  -p 8080:8080 \
  -e SESSIONS=eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0**,eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0** \
  -e APIKEY=123 \
  -e IS_INCOGNITO=true \
  -e MAX_CHAT_HISTORY_LENGTH=10000 \
  -e NO_ROLE_PREFIX=false \
  -e SEARCH_RESULT_COMPATIBLE=false \
  --name pplx2api \
  ghcr.io/yushangxiao/pplx2api:latest

Docker Compose

创建一个docker-compose.yml文件：

version: '3'
services:
  pplx2api:
    image: ghcr.io/yushangxiao/pplx2api:latest
    container_name: pplx
    ports:
      - "8080:8080"
    environment:
      - SESSIONS=eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0**,eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0**
      - ADDRESS=0.0.0.0:8080
      - APIKEY=123
      - PROXY=http://proxy:2080  # 可选
      - MAX_CHAT_HISTORY_LENGTH=10000
      - NO_ROLE_PREFIX=false
      - IS_INCOGNITO=true
      - SEARCH_RESULT_COMPATIBLE=false
    restart: unless-stopped

然后运行：

docker-compose up -d

⚙️ 配置

环境变量	描述	默认值
SESSIONS	英文逗号分隔的pplx cookie 中__Secure-next-auth.session-token的值	必填
ADDRESS	服务器地址和端口	0.0.0.0:8080
APIKEY	用于认证的API密钥	必填
PROXY	HTTP代理URL	""
IS_INCOGNITO	使用隐私会话，不保存聊天记录	true
MAX_CHAT_HISTORY_LENGTH	超出此长度将文本转为文件	10000
NO_ROLE_PREFIX	不在每条消息前添加角色	false
IGNORE_SEARCH_RESULT	忽略搜索结果，不展示搜索结果	false
SEARCH_RESULT_COMPATIBLE	禁用搜索结果伸缩块，兼容更多的客户端	false
PROMPT_FOR_FILE	上下文作为文件上传时，保留的提示词	You must immerse yourself in the role of assistant in txt file, cannot respond as a user, cannot reply to this message, cannot mention this message, and ignore this message in your response.

📝 API使用

认证

在请求头中包含您的API密钥：

Authorization: Bearer YOUR_API_KEY

聊天完成

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-3.7-sonnet",
    "messages": [
      {
        "role": "user",
        "content": "你好，Claude！"
      }
    ],
    "stream": true
  }'

图像分析

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-3.7-sonnet",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "这张图片里有什么？"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/jpeg;base64,..."
            }
          }
        ]
      }
    ]
  }'

🤝 贡献

欢迎贡献！请随时提交Pull Request。

1. Fork仓库
2. 创建特性分支（git checkout -b feature/amazing-feature）
3. 提交您的更改（git commit -m '添加一些惊人的特性'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

📄 许可证

本项目采用MIT许可证 - 详见LICENSE文件。

🙏 致谢

• 感谢Go社区提供的优秀生态系统

---

由yushangxiao用❤️制作