# openai-sub2api

**Repository Path**: c031001/openai-sub2api

## Basic Information

- **Project Name**: openai-sub2api
- **Description**: 将 OpenAI Response API 协议请求转发为 Chat Completions 协议的轻量代理服务，基于 FastAPI 实现。
使用场景：某个中转站只提供了 OpenAI Response API 协议，但你需要使用 Chat Completions 协议
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# openai-sub2api

将 **OpenAI Response API 协议**请求转发为 **Chat Completions 协议**的轻量代理服务，基于 FastAPI 实现。
使用场景：某个中转站只提供了 **OpenAI Response API 协议**，但你需要使用 **Chat Completions 协议**。

## 功能概览
- Chat 协议请求转 Response 协议
- 支持流式与非流式响应
- 提供健康检查与模型列表透传

## 环境要求
- Python `3.11`
- 推荐使用 `uv` 管理依赖

## 快速开始（本地）
```bash
uv sync
uv run uvicorn adapter:app --host 0.0.0.0 --port 8000
```

或：
```bash
uv run python adapter.py
```

## 必要环境变量
在项目根目录创建 `.env`：

```env
RESPONSE_API_BASE=https://your-upstream-response-api
```

可选配置（示例）：`DEFAULT_TIMEOUT`、`MAX_CONNECTIONS`、`STREAM_READ_TIMEOUT`。

## Docker 运行
```bash
docker build -t openai-sub2api .
docker run --rm -p 8000:8000 --env-file .env openai-sub2api
```

## 主要接口
- `POST /v1/chat/completions`
- `GET /v1/models`
- `GET /health`

## 说明
- 启动前请确保上游 `RESPONSE_API_BASE` 可访问。
- 生产环境建议通过反向代理接入，并配置超时与连接池参数。