Free Gemini API is a thin HTTP proxy. It reproduces the StreamGenerate request issued by the Gemini web client, parses the response stream, and returns plain JSON. Built on Node.js and Elysia, with no Puppeteer, no headless browser, and no official SDK in the request path.A Free Gemini API é um proxy HTTP fino. Ela reproduz a requisição StreamGenerate emitida pelo cliente web do Gemini, faz o parse do stream de resposta e retorna JSON puro. Construída sobre Node.js e Elysia, sem Puppeteer, sem navegador headless e sem SDK oficial no caminho da requisição.
$ TOKEN=$(curl -s -X POST \ https://freegemini.felipeestrela.com.br/create-session \ | jq -r .sessionToken) $ curl -s https://freegemini.felipeestrela.com.br/chat \ -H "Authorization: Bearer $TOKEN" \ -d '{"prompt":"Explain streams in Node."}' ⠋ awaiting response…
Breakdown of a single /chat call. All processing performed by this project (JWT verification, session lookup, prompt substitution and stream parsing) totals approximately 2.4 ms. The remainder is the upstream Gemini response. Framework choice affects the blue segments only.Composição de uma única chamada /chat. Todo o processamento realizado por este projeto (verificação do JWT, leitura da sessão, substituição do prompt e parse do stream) soma aproximadamente 2,4 ms. O restante é a resposta do Gemini. A escolha do framework afeta apenas os segmentos azuis.
Measured server-side on 31 July 2026 using process.hrtime across six /chat calls. Each segment is a direct measurement rather than an estimate. StreamGenerate ranged from 3.9 s to 27.5 s and the chart shows the median; the internal steps varied negligibly. Sample size is six, so these figures are indicative and do not constitute a published benchmark. No load testing has been performed.Medição realizada no servidor em 31 de julho de 2026 com process.hrtime, em seis chamadas /chat. Cada segmento é uma medição direta, não uma estimativa. O StreamGenerate variou de 3,9 s a 27,5 s e o gráfico apresenta a mediana; os passos internos tiveram variação desprezível. A amostra é de seis execuções, portanto os valores são indicativos e não constituem benchmark publicado. Não foram realizados testes de carga.
The client does not communicate with Google directly. The proxy maintains session state (a signed JWT, a cookie jar and a captured request snapshot) and forwards each prompt upstream on the client's behalf.O cliente não se comunica diretamente com o Google. O proxy mantém o estado da sessão (um JWT assinado, um conjunto de cookies e um snapshot da requisição capturada) e encaminha cada prompt em nome do cliente.
Issues one cookieless StreamGenerate request, retains the returned Set-Cookie values, persists the snapshot to SQLite and returns a signed JWT.Emite uma requisição StreamGenerate sem cookie, retém os valores de Set-Cookie retornados, persiste o snapshot em SQLite e retorna um JWT assinado.
{ "ok": true,
"sessionToken": "eyJhbGciOiJIUzI1NiIs…",
"expiresInSeconds": 2700
}Accepts a prompt, substitutes it into the captured f.req body, forwards the request using the session cookies and returns the parsed text. The token may be supplied in the Authorization header or the request body.Recebe um prompt, substitui-o no corpo f.req capturado, encaminha a requisição com os cookies da sessão e retorna o texto processado. O token pode ser informado no cabeçalho Authorization ou no corpo da requisição.
{ "ok": true,
"reply": "A stream is an abstraction for…"
}Validates the token against the session store without contacting Google. Always returns HTTP 200; an expired session is reported in the response body rather than as a protocol error.Valida o token contra o armazenamento de sessões sem contatar o Google. Retorna sempre HTTP 200; uma sessão expirada é informada no corpo da resposta, não como erro de protocolo.
{ "ok": true, "valid": false,
"reason": "token_expired"
}Swagger UI backed by a static OpenAPI 3.0 specification. Authorise with a session token to execute requests directly from the browser.Swagger UI apoiado em uma especificação OpenAPI 3.0 estática. Autorize com um session token para executar requisições diretamente do navegador.
$ curl -s .../openapi.json | jq .info { "title": "Free Gemini API", "version": "1.0.0" }
Fixed windows per IP address, held in memory. Each limit is configurable through an environment variable, and a value of 0 disables it. After 45 minutes /chat returns SESSION_EXPIRED and a new session must be created.Janelas fixas por endereço IP, mantidas em memória. Cada limite é configurável por variável de ambiente, e o valor 0 o desativa. Após 45 minutos, /chat retorna SESSION_EXPIRED e uma nova sessão deve ser criada.
The following capabilities are intentionally not implemented. They are documented here so suitability can be assessed before integration.As capacidades a seguir não são implementadas por decisão de projeto. Estão documentadas aqui para que a adequação possa ser avaliada antes da integração.