gemini-web2api - Gemini бесплатно через OpenAI API

Кто-то платит $20/мес за API-доступ к Gemini. Кто-то мучается с прокладками и прокси. А кто-то просто посмотрел на веб-версию Gemini и подумал: «Там же всё уже есть, надо только завернуть в нормальный API».

Так на свет появился gemini-web2api — проект, который за 5 дней собрал почти 1400 звёзд на GitHub и перевернул представление о бесплатном доступе к Google Gemini.

Что это за gemini-web2api

gemini-web2api — это один единственный .py-файл без внешних зависимостей, который поднимает OpenAI-совместимый сервер прямо поверх веб-интерфейса Gemini.

Автор проекта от Sophomoresty, он сделал то, о чём многие мечтали, но никто не решался: реверс-инжиниринг протокола StreamGenerate, который использует сам веб-интерфейс Gemini, и обёртка в формат, понятный OpenAI SDK.

Как это работает

Вместо того чтобы платить за API-ключи или настраивать сложные прокси, gemini-web2api делает вот что:

• Перехватывает запросы в формате OpenAI
• Перекодирует их во внутренний protobuf-подобный протокол Gemini
• Отправляет запросы на тот же endpoint, что и веб-версия
• Возвращает ответ в OpenAI-формате

Всё прозрачно, без танцев с бубном и без единой сторонней библиотеки.

H2: Запуск одной командой

python gemini_web2api.py

После этого сервер поднимается на http://localhost:8081/v1, и к нему можно коннектиться через стандартный OpenAI SDK:

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8081/v1",
    api_key="sk-placeholder"  # можно любую, авторизация отключена
)

Что доступно из моделей

Проект даёт доступ ко всем моделям, которые есть в веб-версии Gemini:

• Gemini Flash — быстрая и лёгкая модель
• Flash Thinking — с выводом более 20 000 токенов
• Gemini Pro — полноценная мощная модель
• Gemini Auto — авто-выбор модели
• Gemini Lite — облегчённая версия

Ключевые возможности

Стриминг

Полноценная потоковая генерация в OpenAI-формате. Никаких отличий от работы с обычным GPT — те же чанки, те же события, тот же парсинг.

Function Calling / Tool Calling

Можно подключать к агентам и инструментам так же, как обычный Gemini API. Это открывает дорогу для использования бесплатного Gemini в серьёзных агентских архитектурах.

Flash Thinking — длинный контекст

Более 20 000 токенов на вывод. Для задач, где нужно много сгенерированного контента за раз — идеально.

Zero Auth из коробки

Не требует ни ключей, ни токенов. Никакой регистрации, никаких платёжных данных. Просто запустил и пользуешься.

Docker из коробки

Деплой в один клик, кроссплатформенно. Можно запустить на любой машине, где есть Docker.

Почему это взорвало GitHub

За 5 дней проект набрал почти 1400 звёзд. Причины понятны:

• Бесплатно. В отличие от $20/мес за официальный API — здесь ноль затрат.
• Простота. Один файл, одна команда, никаких зависимостей.
• Совместимость. Работает через стандартный OpenAI SDK — никакого переписывания кода. Open Source. Можно форкнуть, допилить, разобраться, как оно работает.

Кому это пригодится

Разработчикам AI-агентов — бесплатный Gemini с Function Calling для оркестрации. Инди-стартапам — не платить за API на этапе прототипирования. Исследователям — тестировать модели Gemini без бюрократии. Всем, кто устал от ограничений бесплатных тарифов — веб-версия Gemini имеет свои лимиты, но их можно обойти через параллельные сессии.

Репозиторий проекта