A Node.js proxy server that automatically rotates API keys across multiple providers (OpenAI, Gemini, Groq, OpenRouter, etc.) when rate limits are hit. Features a modern admin panel and zero external dependencies.
- 🔄 Automatic Key Rotation: Seamlessly switches API keys on 429 rate limit errors
- 🏗️ Multi-Provider Support: Works with OpenAI, Gemini, Groq, OpenRouter, Together AI, and any OpenAI-compatible API
- ♾️ Unlimited Scale: Add unlimited providers with unlimited API keys each
- 🎛️ Modern Admin Panel: Dark/light themes, toast notifications, real-time key testing
- ⚡ Full API Compatibility: Supports everything the original APIs do - tool calling, streaming, file uploads, vision, etc.
- 🔥 Zero Dependencies: Pure Node.js with no external packages
- 🔧 Hot Configuration: Add/remove keys without server restart
git clone https://github.com/p32929/openai-gemini-api-key-rotator.git
cd openai-gemini-api-key-rotator
cp .env.example .envEdit .env with minimal setup:
PORT=8990
ADMIN_PASSWORD=your-secure-password💡 Recommended: Use the admin panel at http://localhost:8990/admin to add your providers and API keys through the beautiful web interface!
npm startVisit http://localhost:8990/admin to configure your providers and start using the API.
When you create a provider named groq, your API will be available at:
http://localhost:8990/groq/v1/*
When you create a provider named openrouter, your API will be available at:
http://localhost:8990/openrouter/v1/*
Default Providers: If you name your environment variables like OPENAI_API_KEYS or GEMINI_API_KEYS, they automatically become openai and gemini providers respectively.
Need cURL Examples? 📋 The admin panel generates ready-to-use cURL commands for each provider - just click "Copy cURL" next to any provider!
- 🏭 Provider Management: Create unlimited providers with custom names and URLs
- 🔑 Key Management: Add unlimited API keys per provider
- ✅ Real-time Testing: Test each API key individually before saving
- 📊 Request Monitoring: View live API logs and response details
- 🌙 Beautiful UI: Dark/light themes with smooth animations
- 📱 Mobile Friendly: Perfect experience on all devices
- 📋 Auto-Generated Tests: One-click copy of ready-to-test cURL commands
- Smart Routing: Routes requests to the right provider based on URL (
/provider/v1/*) - Intelligent Key Selection: Avoids recently failed keys using smart shuffling
- Automatic Failover: On rate limits, instantly tries the next available key
- Graceful Handling: Returns proper errors when all keys are exhausted
- Memory-based Logging: Keeps last 100 API requests in memory for real-time monitoring
| Provider | Base URL | What You Get |
|---|---|---|
| Groq | https://api.groq.com/openai/v1 |
Ultra-fast Llama, Mixtral models |
| OpenRouter | https://openrouter.ai/api/v1 |
100+ models including Claude, GPT-4 |
| Together AI | https://api.together.xyz/v1 |
Open source models at scale |
| OpenAI | https://api.openai.com/v1 |
Official GPT models |
| Gemini | https://generativelanguage.googleapis.com/v1 |
Google's powerful AI models |
Just set PORT and ADMIN_PASSWORD, then configure everything through the web interface!
# Named providers (creates custom endpoints)
OPENAI_GROQ_API_KEYS=key1,key2,key3
OPENAI_GROQ_BASE_URL=https://api.groq.com/openai/v1
# Default providers (standard endpoints)
OPENAI_API_KEYS=sk-proj-key1,sk-proj-key2
GEMINI_API_KEYS=AIza_key1,AIza_key2- 🎯 Smart Admin Panel: Intuitive provider creation with real-time validation
- 🍞 Toast Notifications: Professional UI instead of browser alerts
- 📋 Auto-Generated Commands: One-click copy of test cURL commands
- ♾️ Unlimited Everything: No limits on providers or keys per provider
- 🔄 Zero Downtime: Hot reload configuration changes
- 🔐 API keys are masked in all logs
- 🛡️ Password-protected admin access
- 🚫 No API keys stored in browser
- 🔒 Secure session management
🚀 Stop worrying about rate limits. Start building amazing things.