# snailyp/gemini-balance

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/snailyp-gemini-balance).**

5,826 stars · 1,173 forks · Python · other

## Links

- GitHub: https://github.com/snailyp/gemini-balance
- Homepage: https://gb-docs.snaily.top
- awesome-repositories: https://awesome-repositories.com/repository/snailyp-gemini-balance.md

## Topics

`gemini` `gemini-api` `googlesearch` `imagen-3` `load-balancer` `openai-api`

## Tags

### DevOps & Infrastructure

- [API Key Load Balancers](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-ai-clients/api-key-load-balancers.md) — Provides a self-hosted proxy that load balances Gemini API keys with automatic rotation and health checks.
- [API Key Failure Retriers](https://awesome-repositories.com/f/devops-infrastructure/api-service-management/api-resilience/request-retries/api-key-failure-retriers.md) — Re-attempts failed API calls up to a configurable limit and disables keys that exceed a failure threshold. ([source](https://cdn.jsdelivr.net/gh/snailyp/gemini-balance@main/README.md))
- [API Key Rotation](https://awesome-repositories.com/f/devops-infrastructure/load-balancing/api-key-rotation.md) — Distributes requests across multiple Gemini API keys to avoid rate limits and improve reliability.
- [Gemini Key Rotators](https://awesome-repositories.com/f/devops-infrastructure/load-balancing/api-key-rotation/gemini-key-rotators.md) — Distributes Gemini API requests across multiple keys with automatic rotation and health monitoring.
- [Dual-Protocol Endpoints](https://awesome-repositories.com/f/devops-infrastructure/model-serving-endpoints/dual-protocol-endpoints.md) — Accepts requests in both OpenAI and Gemini API formats and routes them to the appropriate backend. ([source](https://cdn.jsdelivr.net/gh/snailyp/gemini-balance@main/README.md))

### Web Development

- [API Proxy Routings](https://awesome-repositories.com/f/web-development/traffic-routing/frontend-version-routing/api-proxy-routings.md) — Serves both Gemini and OpenAI API formats, routing requests to the appropriate backend without client changes.
- [Database-Backed Token Validators](https://awesome-repositories.com/f/web-development/rest-apis/api-response-validation/access-token-validators/database-backed-token-validators.md) — Validates every incoming request against a pre-configured token whitelist stored in the database.

### Artificial Intelligence & ML

- [OpenAI-Compatible APIs](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/ai-integration-apis/openai-compatible-apis.md) — Accepts requests in OpenAI format and translates them to Gemini API calls for client compatibility.
- [Multi-Protocol API Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/ai-integration-apis/openai-compatible-apis/multi-protocol-api-servers.md) — Serves both Gemini and OpenAI API formats, routing requests to the appropriate backend.
- [Image Generation Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/gemini-integrations/image-generation-integrations.md) — Converts text prompts into images using Gemini models through an OpenAI-compatible endpoint.
- [Text-to-Image Generators](https://awesome-repositories.com/f/artificial-intelligence-ml/generative-ai-resources/diffusion-visual-models/generative-ai-pipelines/text-to-image-generators.md) — Generates images from text prompts using Gemini models through an OpenAI-compatible endpoint. ([source](https://cdn.jsdelivr.net/gh/snailyp/gemini-balance@main/README.md))
- [Model Allowlists](https://awesome-repositories.com/f/artificial-intelligence-ml/model-configuration/model-allowlists.md) — Defines which models are enabled, disabled, or reserved for specific features such as image generation. ([source](https://gb-docs.snaily.top/guide/environment.html))
- [Web Search Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/web-search-integrations.md) — Enables models to perform web searches and include result links in responses. ([source](https://cdn.jsdelivr.net/gh/snailyp/gemini-balance@main/README.md))

### Networking & Communication

- [API Protocol Translations](https://awesome-repositories.com/f/networking-communication/cross-chain-messaging-protocols/protocol-translators/messaging-protocol-translation/ai-protocol-translation/api-protocol-translations.md) — Translates incoming requests between OpenAI and Gemini API formats at the proxy layer.
- [API Key Load Balancers](https://awesome-repositories.com/f/networking-communication/load-balancing/api-key-load-balancers.md) — Distributes requests across multiple API keys with automatic retry and failure detection for reliable service. ([source](https://cdn.jsdelivr.net/gh/snailyp/gemini-balance@main/README.md))
- [Dual-Format Request Proxies](https://awesome-repositories.com/f/networking-communication/model-request-proxies/dual-format-request-proxies.md) — Accepts chat requests in both Gemini and OpenAI formats and forwards them to the appropriate backend. ([source](https://gb-docs.snaily.top/guide/introduction.html))

### Security & Cryptography

- [Token Access Restrictions](https://awesome-repositories.com/f/security-cryptography/access-control/panel-access-controls/token-access-restrictions.md) — Checks incoming tokens against a whitelist and rejects unauthorized requests. ([source](https://gb-docs.snaily.top/guide/environment.html))
- [API Key Management](https://awesome-repositories.com/f/security-cryptography/api-key-management.md) — Provides a management interface for adding, monitoring, and rotating multiple Gemini API keys.
- [Key Rotation Strategies](https://awesome-repositories.com/f/security-cryptography/api-key-management/key-rotation-strategies.md) — Cycles through API keys in round-robin order, distributing requests and disabling failed keys.
- [API Key Authentications](https://awesome-repositories.com/f/security-cryptography/oauth-authentication-apis/api-key-authentications.md) — Sets Gemini API keys and access tokens through environment variables for authentication and load balancing. ([source](https://gb-docs.snaily.top/guide/setup-clawcloud-sqlite.html))
- [Request Authentication](https://awesome-repositories.com/f/security-cryptography/request-authentication.md) — Validates incoming requests against a configured token before forwarding them to the upstream API. ([source](https://gb-docs.snaily.top))
- [Health Dashboards](https://awesome-repositories.com/f/security-cryptography/api-key-management/api-key-auditing/health-dashboards.md) — Tracks API key status and failure counts through a real-time dashboard with automatic recovery.
- [Automatic Key Health Testers](https://awesome-repositories.com/f/security-cryptography/api-key-management/api-key-proxying/key-validators/automatic-key-health-testers.md) — Periodically tests disabled API keys and automatically re-enables them upon recovery. ([source](https://gb-docs.snaily.top/guide/environment.html))
- [API Key Status Dashboards](https://awesome-repositories.com/f/security-cryptography/api-key-management/key-lifecycle-dashboards/api-key-status-dashboards.md) — Displays real-time status and failure counts of each API key through an authenticated admin panel. ([source](https://cdn.jsdelivr.net/gh/snailyp/gemini-balance@main/README.md))
- [Consecutive Failure Detectors](https://awesome-repositories.com/f/security-cryptography/key-expiry-management/consecutive-failure-detectors.md) — Marks keys as invalid only after a configurable number of consecutive failures to avoid false positives. ([source](https://gb-docs.snaily.top/guide/faq.html))
- [Web Management Interfaces](https://awesome-repositories.com/f/security-cryptography/ldap-services/web-management-interfaces.md) — Provides a browser-based interface for managing API keys and configuration settings. ([source](https://gb-docs.snaily.top/guide/setup-hf.html))
- [Model Selection Filters](https://awesome-repositories.com/f/security-cryptography/model-safety-filters/model-selection-filters.md) — Removes unwanted models from the available list through simple configuration settings. ([source](https://gb-docs.snaily.top/guide/introduction.html))
- [Persistent Token Authenticators](https://awesome-repositories.com/f/security-cryptography/token-authentication/persistent-token-authenticators.md) — Uses a database-persisted token for management interface access, ignoring later environment variable changes. ([source](https://gb-docs.snaily.top/guide/faq.html))

### Data & Databases

- [Database-Backed Configurations](https://awesome-repositories.com/f/data-databases/database-backed-configurations.md) — Stores API keys, access tokens, and model settings in a persistent database for live configuration changes.

### Development Tools & Productivity

- [Proxy Routing](https://awesome-repositories.com/f/development-tools-productivity/api-route-customization/proxy-routing.md) — Overrides the default API base URL with a custom proxy address for Gemini API calls. ([source](https://gb-docs.snaily.top/guide/faq.html))
- [Configuration Hot-Reloading](https://awesome-repositories.com/f/development-tools-productivity/configuration-hot-reloading.md) — Changes API keys, model settings, and tokens through a web interface without restarting.
- [Live Configuration Reloading](https://awesome-repositories.com/f/development-tools-productivity/keyboard-shortcut-mappings/live-configuration-reloading.md) — Applies configuration changes instantly through a management interface without requiring a service restart. ([source](https://gb-docs.snaily.top/guide/introduction.html))

### Programming Languages & Runtimes

- [Model](https://awesome-repositories.com/f/programming-languages-runtimes/language-features-paradigms/language-features/feature-restrictions/model.md) — Defines per-model enablement and feature-specific access through configuration.

### System Administration & Monitoring

- [Key Recovery](https://awesome-repositories.com/f/system-administration-monitoring/health-checks/key-recovery.md) — Periodically tests disabled API keys and re-enables them when they pass consecutive health checks.
- [Real-Time Monitoring Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring-dashboards.md) — Ships a real-time dashboard for monitoring the status and usage of each API key. ([source](https://gb-docs.snaily.top/guide/introduction.html))