# GPT2API Node

基于 Node.js + Express 的 OpenAI Codex 反向代理服务，支持 JSON 文件导入 token，自动刷新 token，提供 OpenAI 兼容的 API 接口。

## 功能特性

- ✅ OpenAI Codex 反向代理
- ✅ 自动 Token 刷新机制
- ✅ 支持流式和非流式响应
- ✅ OpenAI API 兼容接口
- ✅ JSON 文件导入 Token
- ✅ 简单易用的配置

## 快速开始

### 1. 安装依赖

```bash
cd gpt2api-node
npm install
```

### 2. 配置 Token

从 CLIProxyAPI 或其他来源获取 token 文件，复制到项目根目录并命名为 `token.json`：

```json
{
  "id_token": "your_id_token_here",
  "access_token": "your_access_token_here",
  "refresh_token": "your_refresh_token_here",
  "account_id": "your_account_id",
  "email": "your_email@example.com",
  "type": "codex",
  "expired": "2026-12-31T23:59:59.000Z",
  "last_refresh": "2026-01-01T00:00:00.000Z"
}
```

### 3. 配置环境变量（可选）

复制 `.env.example` 为 `.env` 并修改配置：

```bash
cp .env.example .env
```

```env
PORT=3000
TOKEN_FILE=./token.json
```

### 4. 启动服务

```bash
npm start
```

开发模式（自动重启）：

```bash
npm run dev
```

## API 接口

### 聊天完成接口

**端点**: `POST /v1/chat/completions`

**请求示例**:

```bash
curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.3-codex",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'
```

**流式请求**:

```bash
curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.3-codex",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": true
  }'
```

### 模型列表

**端点**: `GET /v1/models`

```bash
curl http://localhost:3000/v1/models
```

### 健康检查

**端点**: `GET /health`

```bash
curl http://localhost:3000/health
```

## 支持的模型

- `gpt-5.3-codex` - GPT 5.3 Codex（最新）
- `gpt-5.3-codex-spark` - GPT 5.3 Codex Spark（超快速编码模型）
- `gpt-5.2` - GPT 5.2
- `gpt-5.2-codex` - GPT 5.2 Codex
- `gpt-5.1` - GPT 5.1
- `gpt-5.1-codex` - GPT 5.1 Codex
- `gpt-5.1-codex-mini` - GPT 5.1 Codex Mini（更快更便宜）
- `gpt-5.1-codex-max` - GPT 5.1 Codex Max
- `gpt-5` - GPT 5
- `gpt-5-codex` - GPT 5 Codex
- `gpt-5-codex-mini` - GPT 5 Codex Mini

## 在 Cherry Studio 中使用

Cherry Studio 是一个支持多种 AI 服务的桌面客户端。配置步骤：

### 1. 启动代理服务

```bash
cd gpt2api-node
npm start
```

### 2. 在 Cherry Studio 中配置

1. 打开 Cherry Studio
2. 进入 **设置** → **模型提供商**
3. 添加新的 **OpenAI 兼容** 提供商
4. 填写配置：
   - **名称**: GPT2API Node（或自定义名称）
   - **API 地址**: `http://localhost:3000/v1`
   - **API Key**: 随意填写（如 `dummy`），不会被验证
   - **模型**: 选择或手动输入模型名称（如 `gpt-5.3-codex`）

### 3. 开始使用

配置完成后，在 Cherry Studio 中选择刚才添加的提供商和模型，即可开始对话。

### 可用模型列表

在 Cherry Studio 中可以使用以下任意模型：
- `gpt-5.3-codex` - 推荐，最新版本
- `gpt-5.3-codex-spark` - 超快速编码
- `gpt-5.2-codex` - 稳定版本
- `gpt-5.1-codex` - 较旧版本
- 其他 GPT-5 系列模型

## 使用示例

### Python

```python
import openai

client = openai.OpenAI(
    base_url="http://localhost:3000/v1",
    api_key="dummy"  # 不需要真实的 API key
)

response = client.chat.completions.create(
    model="gpt-5.3-codex",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)
```

### JavaScript/Node.js

```javascript
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'http://localhost:3000/v1',
  apiKey: 'dummy'
});

const response = await client.chat.completions.create({
  model: 'gpt-5.3-codex',
  messages: [
    { role: 'user', content: 'Hello!' }
  ]
});

console.log(response.choices[0].message.content);
```

### cURL

```bash
curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.3-codex",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is the capital of France?"}
    ]
  }'
```

## Token 管理

### 自动刷新

服务会自动检测 token 是否过期（提前 5 分钟），并在需要时自动刷新。刷新后的 token 会自动保存到文件中。

### 手动导入

如果你有从 CLIProxyAPI 导出的 token 文件，直接复制为 `token.json` 即可使用。

### Token 文件格式

Token 文件必须包含以下字段：

- `access_token`: 访问令牌
- `refresh_token`: 刷新令牌
- `id_token`: ID 令牌（可选）
- `account_id`: 账户 ID（可选）
- `email`: 邮箱（可选）
- `expired`: 过期时间（ISO 8601 格式）
- `type`: 类型（固定为 "codex"）

## 项目结构

```
gpt2api-node/
├── src/
│   ├── index.js           # 主服务器文件
│   ├── tokenManager.js    # Token 管理模块
│   └── proxyHandler.js    # 代理处理模块
├── package.json
├── .env.example
├── token.example.json
├── .gitignore
└── README.md
```

## 注意事项

1. **Token 安全**: 请妥善保管 `token.json` 文件，不要提交到版本控制系统
2. **网络要求**: 需要能够访问 `chatgpt.com` 和 `auth.openai.com`
3. **Token 有效期**: Token 会自动刷新，但如果 refresh_token 失效，需要重新获取
4. **并发限制**: 根据 OpenAI 账户限制，注意控制并发请求数量

## 故障排除

### Token 加载失败

确保 `token.json` 文件存在且格式正确，参考 `token.example.json`。

### Token 刷新失败

可能是 refresh_token 已过期，需要重新从 CLIProxyAPI 获取新的 token。

### 代理请求失败

检查网络连接，确保能够访问 OpenAI 服务。

## 许可证

MIT License

## 相关项目

- [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) - 原始 Go 语言实现