基于 Python 的桥接服务，为 Warp AI 服务提供 OpenAI Chat Completions API 兼容性，通过利用 Warp 的 protobuf 基础架构，实现与 OpenAI 兼容应用程序的无缝集成。

• OpenAI API 兼容性: 完全支持 OpenAI Chat Completions API 格式
• Warp 集成: 使用 protobuf 通信与 Warp AI 服务无缝桥接
• 双服务器架构:
  • 用于 Warp 通信的 Protobuf 编解码服务器
  • 用于客户端应用程序的 OpenAI 兼容 API 服务器
• JWT 认证: Warp 服务的自动令牌管理和刷新
• 流式支持: 与 OpenAI SSE 格式兼容的实时流式响应
• WebSocket 监控: 内置监控和调试功能
• 消息重排序: 针对 Anthropic 风格对话的智能消息处理

• Python 3.13+
• Warp AI 服务访问权限（需要 JWT 令牌）

1. 克隆仓库:

   git clone <repository-url>
   cd Warp2Api

2. 使用 uv 安装依赖 (推荐):

   uv sync

   或使用 pip:

   pip install -e .

3. 配置匿名JWT TOKEN: 这一步可以什么都不做，程序会自行请求匿名JWT TOKEN

   当然你也可以创建一个包含您的 Warp 凭证的 .env 文件，用自己的订阅额度，不过这并不推荐:

   WARP_JWT=your_jwt_token_here
   WARP_REFRESH_TOKEN=your_refresh_token_here

1. 启动 Protobuf 桥接服务器:

   python server.py

   默认地址: http://localhost:8000

2. 启动 OpenAI 兼容 API 服务器:

   python openai_compat.py

   默认地址: http://localhost:8010

两个服务器都运行后，您可以使用任何 OpenAI 兼容的客户端:

import openai

client = openai.OpenAI(
    base_url="http://localhost:8010/v1",
    api_key="dummy"  # 不是必需的，但某些客户端需要
)

response = client.chat.completions.create(
    model="claude-3-sonnet",  # 模型名称会被传递
    messages=[
        {"role": "user", "content": "你好，你好吗？"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

• GET /healthz - 健康检查
• POST /encode - 将 JSON 编码为 protobuf
• POST /decode - 将 protobuf 解码为 JSON
• WebSocket /ws - 实时监控

• GET / - 服务状态
• GET /healthz - 健康检查
• POST /v1/chat/completions - OpenAI Chat Completions 兼容端点

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│    客户端应用     │───▶│  OpenAI API     │───▶│   Protobuf      │
│  (OpenAI SDK)   │    │     服务器      │    │    桥接服务器    │
└─────────────────┘    │  (端口 8010)    │    │  (端口 8000)    │
                       └─────────────────┘    └─────────────────┘
                                                       │
                                                       ▼
                                              ┌─────────────────┐
                                              │    Warp AI      │
                                              │      服务       │
                                              └─────────────────┘

• protobuf2openai/: OpenAI API 兼容层

  • 消息格式转换
  • 流式响应处理
  • 错误映射和验证

• warp2protobuf/: Warp protobuf 通信层

  • JWT 认证管理
  • Protobuf 编解码
  • WebSocket 监控
  • 请求路由和验证

在 pyproject.toml 中定义:

# 启动 protobuf 桥接服务器
warp-server

# 启动 OpenAI API 服务器  
warp-test

服务会自动处理 Warp 认证:

1. JWT 管理: 自动令牌验证和刷新
2. 匿名访问: 在需要时回退到匿名令牌
3. 令牌持久化: 安全的令牌存储和重用

Warp2Api/
├── protobuf2openai/          # OpenAI API 兼容层
│   ├── app.py               # FastAPI 应用程序
│   ├── router.py            # API 路由
│   ├── models.py            # Pydantic 模型
│   ├── bridge.py            # 桥接初始化
│   └── sse_transform.py     # 服务器发送事件
├── warp2protobuf/           # Warp protobuf 层
│   ├── api/                 # API 路由
│   ├── core/                # 核心功能
│   │   ├── auth.py          # 认证
│   │   ├── protobuf_utils.py # Protobuf 工具
│   │   └── logging.py       # 日志设置
│   ├── config/              # 配置
│   └── warp/                # Warp 特定代码
├── server.py                # Protobuf 桥接服务器
├── openai_compat.py         # OpenAI API 服务器
└── pyproject.toml           # 项目配置

主要依赖项包括:

• FastAPI: 现代、快速的 Web 框架
• Uvicorn: ASGI 服务器实现
• HTTPx: 支持 HTTP/2 的异步 HTTP 客户端
• Protobuf: Protocol buffer 支持
• WebSockets: WebSocket 通信
• OpenAI: 用于类型兼容性

1. JWT 令牌过期

   • 服务会自动刷新令牌
   • 检查日志中的认证错误
   • 验证 WARP_REFRESH_TOKEN 是否有效

2. 桥接服务器未就绪

   • 确保首先运行 protobuf 桥接服务器
   • 检查 BRIDGE_BASE_URL 配置
   • 验证端口可用性

3. 连接错误

   • 检查到 Warp 服务的网络连接
   • 验证防火墙设置
   • 如适用，检查代理配置

两个服务器都提供详细的日志记录:

• 认证状态和令牌刷新
• 请求/响应处理
• 错误详情和堆栈跟踪
• 性能指标

该项目配置为内部使用。请与项目维护者联系了解许可条款。

1. Fork 仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交 pull request

如有问题和疑问:

1. 查看故障排除部分
2. 查看服务器日志获取错误详情
3. 创建包含重现步骤的 issue