Gemini Relay

Gemini Relay

Route Gemini.
Debug with intent.

A lean API proxy plus a local playground for streaming chat—keys stay in this browser only.

Open PlaygroundDocs

How to use

Three steps to exercise the proxy stream.

  1. 01Open Playground → Settings, enter your API key, and save.
  2. 02Return to chat, refresh models, and pick a model.
  3. 03Send a message to test streaming; Clear resets the session.

API quick start

Paths under /api/v1, /api/v1beta, /api/v1beta2.

Passthrough

Caller sends a Gemini key via ?key= or x-goog-api-key.

curl
curl "$HOST/api/v1beta/models?key=$GEMINI_API_TOKEN"

Proxy mode

Server holds GEMINI_API_KEYS; callers send headers from PROXY_AUTH_HEADERS (e.g. X-API-KEY).

curl
curl "$HOST/api/v1beta/models" -H "X-API-KEY: <secret>"

Deploy your own instance and set env vars — see the full API guide.