gpt2api · KleinAI

Gateway AIGC OpenAI compatibile con pool duali di account GPT / GROK

Soluzione completa per generazione di contenuti testuali, immagini e video, con gestione di pool multipli di account, compatibilità con il protocollo OpenAI e sistema di fatturazione a punti. Deploy rapido via Docker.

Introduzione

gpt2api (nome in codice KleinAI) è un gateway aggregatore AIGC di livello produttivo che incapsula abilità di account GPT / GROK basati su sistema Cookie rendendoli compatibili con il protocollo OpenAI. Consente a qualsiasi applicazione sviluppata con SDK OpenAI di integrarsi senza problemi.

La piattaforma offre:

• Un'interfaccia per utenti finali per creare testi, immagini e video
• Un backend amministrativo per gestire pool di account, proxy, fatturazione a punti, codici CDK e log
• Un'interfaccia HTTP compatibile con OpenAI verso l'esterno

Applicazioni ideali: servizi AIGC privati, SaaS white-label, gestione multi-account conforme, aggregazione per team interni.

La versione attuale è v2.0.1, consigliato evolversi nelle 2.x; la serie 1.0.x è una base stabile storica.

Caratteristiche

Capacità di creazione

Gestione e stabilità

• Pool multipli di account GPT / GROK con importazione massiva, monitoraggio stato, auto-refresh, circuito di rottura e rotazione
• Pool proxy con importazione, rimozione e test massivo
• Strategie proxy: binding account prioritario, fallback globale in modalità proxy fisso o casuale
• Logging completo end-to-end con analisi dettagliata errori e comunicazioni
• Sistema di fatturazione unificato a punti configurabile per modello, risoluzione e durata

Capacità Operative (Dashboard)

• Dashboard, gestione token/account, gestione proxy, utenti, ricariche e consumi
• Codici promozionali, scambio CDK, prezzi modelli, configurazioni, log richieste e upstream
• Configurazioni tramite form senza necessità di inserire JSON manualmente

Tech Stack

┌────────────┐    ┌────────────┐    ┌────────────────────┐  
│  Frontend  │    │ Admin UI   │    │ Client SDK compatibile │  
└─────┬──────┘    └─────┬──────┘    └──────────┬─────────┘  
      │ :17080          │ :17088               │ :17200    
      ▼                 ▼                      ▼          
┌────────────────────────────────────────────────────────┐
│   Nginx / Caddy    (SSL, reverse proxy, rate limit, static) │ 
└──────┬──────────────┬──────────────────┬───────────────┘
       │              │                  │                  
   ┌───▼────┐    ┌────▼────┐         ┌───▼─────┐            
   │ user-api│    │admin-api│         │openai-api│  (multi servizio Go) 
   └───┬────┘    └────┬────┘         └───┬─────┘            
       └──────┬───────┴──────┬───────────┘                  
              │              │                                
        ┌─────▼─────┐  ┌─────▼─────┐                        
        │   MySQL   │  │   Redis   │                        
        └───────────┘  └───────────┘                        

Installazione rapida

Requisiti

• Linux/macOS/Windows (consigliato Linux)
• Docker 24+ e Docker Compose v2
• Un dominio oppure 3 sottodomini per produzione
• Porte 80 e 443 liberate

Passi

git clone https://github.com/432539/gpt2api.git
cd gpt2api
cp deploy/env/.env.example deploy/env/.env.prod
# Modificare .env.prod con parametri database, Redis, segreti JWT/AES, domini, upstream GPT/GROK, proxy
cd deploy
docker compose -f docker-compose.server.yml up -d --build

Verifica

docker compose -f docker-compose.server.yml ps
docker logs -f klein-api
# controllare anche klein-admin, klein-openai, klein-worker

Endpoint principali

Uso API OpenAI compatibile

Configura il parametro base_url del client OpenAI per puntare a questo servizio:

from openai import OpenAI
client = OpenAI(base_url="https://tuo-dominio:17200/v1", api_key="sk-xxxx")

# Chat testuale
resp = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role":"user", "content":"ciao"}])

# Generazione immagini
img = client.images.generate(model="gpt-image-2", prompt="volpe cyberpunk sotto fiori di ciliegio a Kyoto", size="1024x1024", n=4)

# Generazione video (720p/1080p)
import httpx
r = httpx.post(
    "https://tuo-dominio:17200/v1/video/generations",
    headers={"Authorization": "Bearer sk-xxxx"},
    json={"model": "grok-video", "prompt": "gatto che cammina sotto neon in una notte di pioggia", "aspect_ratio": "16:9", "quality": "hd", "duration": 6},
    timeout=600
)
print(r.json())

Porte predefinite

Configurazione

Strategia proxy globale

Gestibile in "Admin → Sistema":

• proxy.global_enabled: abilita fallback proxy globale
• proxy.selection_mode: fixed (proxy fisso) o random (proxy casuale)
• Nel modo fixed si specifica proxy.global_id con un proxy
• Nel modo random viene scelto ogni volta un proxy dalla lista attiva
• Binding proxy a livello account ha priorità sulla strategia globale

Gestione token/account

• Supporta provider GPT e GROK con importazione linea per linea
• Rilevamento automatico tipo account (basic, super, heavy) e filtro
• Binding proxy di tipo single (molti account ad un proxy) o cycle (più proxy ruotati)

Sviluppo locale

Metodo A: contenitori completi

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

Metodo B: hot reload semi-container

# Solo MySQL/Redis nei container
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

Impostazione predefinita usa mock provider, non serve credenziale reale. Per canali reali modificare .env.local o docker-compose secondo documentazione.

Raccomandazioni per produzione

• Utilizzare sottodomini distinti per front-end, admin e API OpenAI compatibile
• Limitare accessi admin tramite whitelist IP a livello Nginx
• Configurare rate limit per il proxy API OpenAI
• Gestire certificati SSL centralizzati con Caddy o Nginx
• Usare object storage o cache locale per asset multimediali per sicurezza e performance
• Configurare la pulizia automatica cronologica di dati storici e risultati

Documentazione

• Panoramica linee guida sviluppo
• Standard backend
• Design database
• API specification
• Frontend guidelines
• Deployment & operation

Changelog

Dettagli in PROGRESS.md.

v2.0.1 (2026-05-04)

• Corretto qualità video di default da 480p a 1080p, aggiunta configurazione qualità (standard/hd)
• Estese funzionalità di gestione proxy con importazione, cancellazione e test in batch
• Aggiunta visualizzazione tipo account e filtro nella gestione token
• Nuove modalità di assegnazione proxy multiple: single e cycle
• Introduzione modalità proxy casuale
• Miglioramenti compatibilità logging upstream senza cambi schema distruttivi

Comunità e supporto

• Issues: https://github.com/432539/gpt2api/issues
• Gruppo QQ tecnico: 382446
• Sito ufficiale: www.gpt2api.com

Licenza

Il codice è per scopi di apprendimento e ricerca. Uso commerciale richiede verifica di conformità con termini upstream e normative locali. L'autore declina ogni responsabilità per danni causati da questo progetto.

Costruito con ❤️ per la comunità AIGC.