one880808/gemini-web2api — explained in plain English
Analysis updated 2026-05-18
Connect an existing OpenAI-compatible app to Gemini without paying for a Gemini API subscription.
Add streaming chat and function calling powered by Gemini to a tool built for OpenAI's API format.
Give a coding CLI like Codex or Gemini CLI access to Gemini models through a compatible endpoint.
Add web search answers backed by Gemini's native search feature to an existing chatbot.
| one880808/gemini-web2api | bwilky/ha-spotify-browser | netflix/ember-batch-request | |
|---|---|---|---|
| Stars | 49 | 50 | 48 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | — | — | 2023-03-24 |
| Maintenance | — | — | Dormant |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 3/5 | 2/5 | 3/5 |
| Audience | developer | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires deploying to Cloudflare Workers and understanding the reverse-engineered auth flow, no image uploads supported.
gemini-web2api is a Cloudflare Workers adaptation of an existing project that lets you talk to Google Gemini through an API format normally used with OpenAI tools. The idea is to take what Gemini offers through its web interface and make it accessible to software that expects to send requests in the OpenAI style, without paying for a Gemini API subscription. You deploy a single JavaScript file to Cloudflare Workers, which acts as a go-between. When your software sends a request in OpenAI format, the worker translates it into the internal format that Gemini's website uses, sends it to Google, then converts the response back before returning it to your software. The translation works by reverse-engineering the data format that Google's web client uses internally. Several Gemini model variants are supported, including Flash, Flash Thinking (which can produce longer outputs), Pro, Auto, and Lite. The Pro label in this context routes to Flash models unless you have a paid Gemini subscription cookie, so it is a preference label rather than a true model switch. Authentication is optional. If you leave the key list empty, anyone can use your deployed worker without a password. You can add API keys to require a bearer token in the same format OpenAI tools use. The service supports streaming responses, function calling in OpenAI format, and a built-in web search feature that uses Gemini's native search capability. It also exposes a Responses API endpoint for Codex CLI compatibility and a native Gemini API endpoint for the Gemini CLI. Known limitations: image and other multimodal inputs are not supported because uploading files to Gemini requires a proprietary protocol that cannot be replicated through standard HTTP. Each request is also treated as a fresh conversation, multi-turn context is simulated by including prior messages in the prompt rather than maintaining a real session. Google may also rate-limit or block high-volume usage.
A worker script that lets OpenAI-style apps talk to Google Gemini for free by mimicking Gemini's web interface.
Mainly JavaScript. The stack also includes JavaScript, Cloudflare Workers.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.