Documentation

Base URL: https://www.gemini-api.site

Authentication

All /v1/ endpoints require a bearer token, sent as an Authorization header. Tokens are issued privately — there is no public sign-up.

Authorization: Bearer YOUR_KEY

Models

ModelDescription
gemini-3.8-flashDefault. Fast, current-generation flash model.
gemini-3.5-flashPrevious generation, kept as a fallback.
gemini-2.5-flashOlder generation, kept for compatibility.
model:autoLet the gateway pick the default model.

List models

GET /v1/models

Chat completions

OpenAI-compatible chat endpoint.

POST /v1/chat/completions
Content-Type: application/json

{
  "model": "model:auto",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ]
}

Rate limits

This is a personal gateway. Fair use applies; abusive traffic is blocked at the gateway. If you are seeing 503 responses, Google's side is busy — retry after a short wait.

Changelog