中文文档

Convert Google Gemini's web interface into an OpenAI-compatible API. Zero authentication, zero cost, cross-platform.

• Zero Auth: No API key, no Google account needed (anonymous access)
• OpenAI Compatible: Drop-in replacement for /v1/chat/completions and /v1/models
• Tool Calling: Full function calling support (OpenAI format)
• Multiple Models: Flash, Flash Thinking (20k+ char output), Pro, Auto, Lite
• Thinking Depth: Adjustable via @think=N suffix (0=deepest, 4=shallowest)
• Web Search: Built-in internet access (Gemini's native search)
• Cross-Platform: Pure Python, no dependencies beyond stdlib
• Streaming: SSE streaming support
• Codex CLI: Responses API (/v1/responses) for OpenAI Codex integration

python gemini_web2api.py

Server starts at http://localhost:8081/v1.

curl http://localhost:8081/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"Hello!"}]}'

from openai import OpenAI
client = OpenAI(base_url="http://localhost:8081/v1", api_key="none")
resp = client.chat.completions.create(
    model="gemini-3.5-flash-thinking",
    messages=[{"role": "user", "content": "Explain quantum computing"}]
)
print(resp.choices[0].message.content)

Append @think=N to any model name:

gemini-3.5-flash-thinking@think=0   # deepest (default)
gemini-3.5-flash-thinking@think=2   # medium
gemini-3.5-flash-thinking@think=4   # shallowest

Anonymous access works for all models, but gemini-3.1-pro routes to Flash without authentication. To get real Pro routing, provide a cookie file:

python gemini_web2api.py --cookie-file cookie.txt

1. Open Chrome, go to gemini.google.com and sign in with any free Google account
2. Open DevTools (F12) → Application → Cookies → https://gemini.google.com
3. Copy these cookie values: SID, HSID, SSID, APISID, SAPISID, __Secure-1PSID
4. Create cookie.txt in this format:

SID=your_sid_value; HSID=your_hsid_value; SSID=your_ssid_value; APISID=your_apisid_value; SAPISID=your_sapisid_value; __Secure-1PSID=your_1psid_value

Or use the JSON format:

{"cookie": "SID=xxx; HSID=xxx; SSID=xxx; APISID=xxx; SAPISID=xxx; __Secure-1PSID=xxx", "sapisid": "your_sapisid_value"}

Alternative (browser extension): Use any "Export Cookies" extension to export cookies for gemini.google.com in Netscape format, then convert to the single-line format above.

No paid subscription needed — a free Google account is sufficient.

Create config.json in the same directory:

{
  "port": 8081,
  "host": "0.0.0.0",
  "retry_attempts": 3,
  "retry_delay_sec": 2,
  "request_timeout_sec": 180,
  "cookie_file": null,
  "proxy": null,
  "log_requests": true
}

If you cannot access gemini.google.com directly (connection timeout), configure a proxy:

Method 1: CLI argument

python gemini_web2api.py --proxy http://127.0.0.1:7890

Method 2: config.json

{"proxy": "http://127.0.0.1:7890"}

Method 3: Environment variable (auto-detected)

export HTTPS_PROXY=http://127.0.0.1:7890
python gemini_web2api.py

Works with Clash, V2Ray, Shadowsocks, or any HTTP proxy.

resp = client.chat.completions.create(
    model="gemini-3.5-flash",
    messages=[{"role": "user", "content": "What's the weather in Tokyo?"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get weather for a city",
            "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]}
        }
    }]
)

• Python 3.8+
• No external dependencies (stdlib only)
• Network access to gemini.google.com (proxy/VPN may be needed in some regions)

This tool reverse-engineers Google Gemini's web StreamGenerate protocol. It sends requests to the same endpoint that the Gemini web app uses, converting between OpenAI's API format and Gemini's internal protobuf-like format.

The model selection is controlled by field [79] in the request payload, mapped from Gemini's frontend JavaScript source (MODE_CATEGORY enum).

• linux.do community
• Inspired by the open-source API proxy ecosystem

MIT