MIT License
TypeScript
Next.js 15
Supabase
Ant Design

Gemini Proxy

Production-Ready API Proxy for Google Gemini

Secure key management, intelligent load balancing, comprehensive monitoring, and seamless streaming. Deploy anywhere with our multi-platform support.

🚀 Core Features

Everything you need to manage, monitor, and scale your Gemini API usage
🔑 API Key Management
Secure storage and intelligent rotation of multiple Google Gemini API keys with real-time usage tracking.
Secure Storage
Key Rotation
Usage Analytics
⚡ Load Balancing
Intelligent request distribution across multiple API keys with automatic failover and retry mechanisms.
Auto Distribution
Failover
Retry Logic
📊 Monitoring & Analytics
Real-time request logging, performance metrics, cost tracking, and comprehensive dashboards.
Real-time Logs
Performance Metrics
Cost Tracking
🛡️ Security & Access Control
Proxy API key management, request authentication, rate limiting, and secure environment handling.
Authentication
Rate Limiting
Secure Storage
📝 Comprehensive Logging
Detailed request/response logs with performance metrics, retry attempts, and export capabilities.
Request Logs
Response Tracking
Export Data
🌍 Multi-Platform Support
Deploy anywhere with support for Next.js, Vercel, Cloudflare, Appwrite, and standalone servers.
Next.js
Vercel
Cloudflare

💻 Integration Examples

Get started in minutes with our comprehensive SDK examples
🚀 Quick Start Examples
Use the official Google Generative AI SDK with our proxy endpoint:
1import { GoogleGenAI } from '@google/genai';
2
3const genAI = new GoogleGenAI({
4    apiKey: 'YOUR_PROXY_API_KEY',
5    httpOptions: {
6        baseUrl: 'http://localhost:9090/api/gproxy/gemini',
7    },
8});
9
10// Generate content
11const response = await genAI.models.generateContent({
12    model: 'gemini-2.0-flash',
13    contents: 'Count from 1 to 10',
14});
15
16console.log(response.text);

🛠️ Tech Stack

Built with modern, production-ready technologies
Next.js 15
Framework
React framework with App Router
React 19
Library
UI library for building interfaces
TypeScript
Language
Typed JavaScript at any scale
Refine v5
Framework
React-based admin panel framework
Ant Design
UI Library
Enterprise UI design language
Supabase
Database
Open source Firebase alternative
Hono
Framework
Lightweight web framework

🌐 Deployment Options

Choose the deployment option that best fits your needs
🎯 Next.js Web App
Full-Stack
Complete solution with web interface + API proxy in one deployment. Built-in dashboard for managing API keys and monitoring.
Supported Platforms:
Vercel
Netlify
AWS
Web Dashboard
API Proxy
User Management
⚡ Standalone API
API-Only
Lightweight Node.js API server with minimal resource usage. Perfect for custom deployments and microservices.
Supported Platforms:
Node.js
Deno
Bun
TypeScript
Lightweight
Customizable
Scalable
🚀 Edge Functions
Serverless
Deploy to Vercel, Cloudflare, or Appwrite for global CDN distribution and automatic scaling.
Supported Platforms:
Vercel
Cloudflare
Appwrite
Supabase
Global CDN
Auto-scaling
Low Latency

🏗️ Architecture

Simple, secure, and scalable architecture for production use
🔄 How It Works

Your Application

Makes API requests using your preferred SDK
→

Gemini Proxy

Intelligently routes requests to healthy API keys, logs request/response data, and manages load balancing
→

Google Gemini API

Processes your AI requests

📊 Data Storage

All data is securely stored in Supabase PostgreSQL with Row Level Security (RLS) enabled for maximum protection. API keys, request logs, and analytics are stored with proper access controls and are accessible only to authorized users.

🔒 Security Features

Built with enterprise-grade security including RLS policies, typed RPCs, secure environment handling, and comprehensive audit logging for compliance.
🚀 Gemini Proxy
Production-ready proxy for Google Gemini with secure key management, intelligent load balancing, and comprehensive monitoring.
🛠️ Built With
Next.js 15
Refine v5
Ant Design
Supabase
TypeScript
© 2026 Gemini Proxy • Made with ❤️ by lehuygiang28