gpt2api（项目代号 KleinAI）是一个生产级的 AIGC 聚合网关，把 GPT / GROK 这类账号 + Cookie 体系的能力，整体封装成 OpenAI 兼容协议，让任何按 OpenAI SDK 编写的程序都可以无缝接入。

平台同时提供：

• 一套面向终端用户的创作前台（图 / 文 / 视频）
• 一套面向运营的管理后台（账号池、代理、计费、CDK、日志）
• 一套对外暴露的 OpenAI 兼容 HTTP 接口

适用场景：私有化 AIGC 服务、白标 SaaS、多账号合规分发、内部团队调用聚合。

当前默认版本：v2.0.1，建议直接以 v2.0.x 演进；v1.0.x 保留为历史稳定基线。

• 多账号池：GPT / GROK 账号批量导入、健康检测、自动刷新、熔断、轮换
• 代理池：批量导入（scheme://user:pass@host:port#name）、批量删除、批量测试
• 代理策略：账号级绑定优先，全局回落支持「固定代理」与「随机代理」两种模式
• 请求观测：上游全链路日志可追踪，失败任务可看到完整 provider 报文
• 统一计费：积分制，按模型 / 分辨率 / 时长可配置

• 仪表盘、Token（账号）管理、代理管理、用户管理、充值消费
• 优惠码、CDK 兑换、模型价格、系统配置、请求日志、上游日志
• 所有配置尽量表单化，避免裸 JSON 手填

┌────────────┐    ┌────────────┐    ┌────────────────────┐
│  用户前台  │    │  管理后台  │    │ OpenAI 兼容 SDK 客户端 │
└─────┬──────┘    └─────┬──────┘    └──────────┬─────────┘
      │ :17080          │ :17088               │ :17200
      ▼                 ▼                      ▼
┌────────────────────────────────────────────────────────┐
│   Nginx / Caddy    （SSL · 反代 · 限流 · 静态资源）       │
└──────┬──────────────┬──────────────────┬───────────────┘
       │              │                  │
   ┌───▼────┐    ┌────▼────┐         ┌───▼─────┐
   │ user-api│    │admin-api│         │openai-api│   ← Go 多服务
   └───┬────┘    └────┬────┘         └───┬─────┘
       └──────┬───────┴──────┬───────────┘
              │              │
        ┌─────▼─────┐  ┌─────▼─────┐
        │   MySQL   │  │   Redis   │
        └───────────┘  └───────────┘

• Linux / macOS / Windows（推荐 Linux）
• Docker 24+ 与 Docker Compose v2
• 1 个域名或 3 个子域名（生产部署推荐）
• 80 / 443 端口可用

git clone https://github.com/432539/gpt2api.git
cd gpt2api

cp deploy/env/.env.example deploy/env/.env.prod
# 编辑 .env.prod，重点检查：
#   - 数据库 / Redis 连接
#   - JWT_SECRET / AES_KEY（务必修改！）
#   - 域名 / CORS 来源
#   - GPT / GROK 上游基础地址
#   - 代理 / FlareSolverr 地址

cd deploy
docker compose -f docker-compose.server.yml up -d --build

docker compose -f docker-compose.server.yml ps
docker logs -f klein-api
docker logs -f klein-admin
docker logs -f klein-openai
docker logs -f klein-worker

直接把 OpenAI SDK 的 base_url 指向本服务即可：

from openai import OpenAI

client = OpenAI(
    base_url="https://your-domain:17200/v1",
    api_key="sk-xxxxxxxx",  # 在用户前台「密钥」页生成
)

# 文字对话
resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)

# 图片生成
img = client.images.generate(
    model="gpt-image-2",
    prompt="一只在京都樱花树下的赛博狐狸，电影质感",
    size="1024x1024",
    n=4,
)

# 视频生成（v2.0.1 起默认 720p / 1080p）
import httpx
r = httpx.post(
    "https://your-domain:17200/v1/video/generations",
    headers={"Authorization": "Bearer sk-xxxxxxxx"},
    json={
        "model": "grok-video",
        "prompt": "在雨夜霓虹中漫步的猫",
        "aspect_ratio": "16:9",
        "quality": "hd",      # standard=720p, hd=1080p
        "duration": 6,
    },
    timeout=600,
)
print(r.json())

在「管理后台 → 系统配置」中：

• proxy.global_enabled：是否启用全局代理回落
• proxy.selection_mode：fixed（固定代理） / random（随机代理）
  • fixed 模式下需要在 proxy.global_id 指定一个代理
  • random 模式下每次任务从启用代理中随机挑一个
• 账号级绑定的 proxy_id 始终优先于全局策略

• 支持 GPT / GROK 双 Provider，导入时按行解析
• 导入后会自动针对 GROK Cookie 账号触发探测，识别账号类型（basic / super / heavy）并回填到列表
• 列表支持按「账号类型」过滤
• 支持批量绑定代理：single（多账号绑同一代理） / cycle（多账号轮询绑定多个代理）

cd deploy
docker compose -f docker-compose.dev-full.yml up -d --build

# 仅 MySQL / Redis 走容器
pwsh ./scripts/dev-up.ps1

# 前端
cd frontend
pnpm install
pnpm --filter @kleinai/user  dev    # http://localhost:5173
pnpm --filter @kleinai/admin dev    # http://localhost:5174

默认 KLEIN_PROVIDER_GPT/GROK=mock，无需真实凭证即可走通生成全流程。 切真实通道：编辑 deploy/docker-compose.dev-full.yml 或 backend/.env.local，把 KLEIN_PROVIDER_*=real。 真实凭证一律通过「管理后台 → Token 管理」入库，AES-256-GCM 落盘。

• 前台 / 后台 / OpenAI API 分子域名部署，结构更清晰
• 管理后台建议在 Nginx 层加 IP 白名单
• OpenAI 兼容接口建议独立子域并启用限流
• 80 / 443 由 Caddy / Nginx 统一接管 SSL
• 图片 / 视频素材建议落 OSS 或本地缓存，避免直接暴露上游地址
• 定期清理 storage.history_retention_days 与 storage.result_retention_days 控制磁盘

• 开发规范 - 总览
• 后端规范
• 数据库设计
• API 规范
• 前端规范
• 部署与运维规范

详见 PROGRESS.md。

• 修复 视频生成默认仍走 480p 的问题，默认改为 1080p，并补齐 quality = standard | hd 入参（720p / 1080p），保留更高分辨率扩展位
• 代理管理 补齐批量导入（按行解析）、批量删除、批量并发测试（信号量并发 4）
• Token 管理 新增账号类型展示与按类型过滤（basic / super / heavy），导入后自动并发探测识别并回填
• Token 管理 新增批量代理分配：single（多对一）与 cycle（多对多轮询）
• 系统配置 新增「随机代理」模式，每次任务从启用代理中随机挑选
• 上游日志、生成链路保持兼容，无破坏性 schema 变更

如果这个项目对你有帮助，欢迎点一个 ⭐ 支持持续更新。

• GitHub Issues：https://github.com/432539/gpt2api/issues
• 技术交流 QQ 群：382446
• 官网：www.gpt2api.com

仓库代码用于 学习与研究。商用前请自行评估上游服务条款与所在地区的合规风险，作者不对使用本项目造成的任何后果负责。