ntthanh2603/gemini-web-to-api

✨Reverse-engineered API for Gemini web app. It can be used as a genuine API key from OpenAI, Gemini, and Claude.

해결하는 문제

이 프로젝트는 공식 API 키 없이 표준화된 REST API를 통해 Google Gemini의 최신 모델에 접근할 수 있는 방법을 제공합니다. 공식 API를 우회하여 브라우저 쿠키를 사용해 Gemini 웹 인터페이스에 인증 요청을 보내며, 사용자가 Gemini를 자체 애플리케이션에 통합하거나 로컬에서 테스트할 수 있도록 합니다.

작동 방식

이 도구는 Go와 Fiber로 구축된 로컬 프록시 서버로, 사용자로부터 OpenAI, Claude 또는 Gemini 호환 엔드포인트를 통해 들어오는 요청을 수신하고, Gemini 웹 인터페이스가 이해할 수 있는 요청으로 변환합니다. 사용자가 제공한 브라우저 쿠키와 계정 슬롯을 사용하여 세션을 유지하고, 자동으로 쿠키를 교체하여 세션을 지속적으로 활성화합니다.

대상 사용자

  • API 키 없이 Gemini 모델을 사용하고 싶은 개발자.
  • 로컬에서 Gemini 통합을 테스트하고 싶은 사용자.
  • 쿠키 기반 인증 방식을 통해 최신 Gemini 모델을 활용하는 애플리케이션을 개발하는 개발자.

주요 기능

  • 다중 프로토콜 지원: OpenAI, Claude, Gemini SDK와 호환되는 엔드포인트 제공.
  • 자동 세션 관리: 세션 만료를 방지하기 위해 쿠키 자동 회전 처리.
  • 동적 모델 탐지: 사용자 계정 레지스트리에서 사용 가능한 모델을 자동으로 탐지.
  • 다중 모달 기능: 채팅 요청에서 이미지 생성(텍스트 → 이미지) 및 이미지 입력(URL 또는 base64) 지원.
  • 프로덕션 준비 완료: Docker 및 Docker Compose 지원, 레이트 제한, Scalar UI를 통한 인터랙티브 API 문서 포함.

관련

  • 프로젝트
    Nativu5/Gemini-FastAPI

    API 키 대신 세션 쿠키를 사용하여 무료로 웹 기반 Gemini 모델에 접근할 수 있는 OpenAI 호환 API 래퍼입니다.

  • 프로젝트
    zexadev/gemini-web2api-go

    A Go server that reverse‑proxies Google Gemini’s web UI protocol and exposes it as an OpenAI‑compatible API (chat, models, streaming, video, image, music, web‑search). Works anonymously or with Google cookies, includes rate‑limiting, proxy & cookie pools, SQLite/MySQL persistence, and a lightweight admin UI.

  • 프로젝트
    zhiyu1998/Gemi2Api-Server

    Gemi2Api‑Server is a FastAPI‑based bridge that lets you call Google Gemini via an OpenAI‑compatible REST API. It authenticates with Gemini using your browser cookies, forwards chat‑completion requests, optionally proxies generated images, and provides a simple admin UI. Deployable locally, via Docker, or on Render/HuggingFace, it’s useful for developers who want Gemini access without a formal public API.

  • 프로젝트
    Amm1rr/WebAI-to-API

    WebAI‑to‑API는 Google Gemini(웹 API 또는 Playwright 기반 브라우저를 통해)를 자체 호스팅 브리지로 실행하고, OpenAI 호환 엔드포인트를 제공하며, 로컬 대시보드와 Docker 지원을 갖춘 도구입니다.

  • 프로젝트
    Sophomoresty/gemini-web2api

    gemini‑web2api는 Google Gemini의 비공개 웹 API를 프록시하고 OpenAI 호환 엔드포인트(`/v1/chat/completions`, `/v1/models` 등)로 제공하는 Python 서버입니다. 선택적 API 키 인증, 스트리밍, 함수 호출, 이미지 입력, 여러 Gemini 모델 별칭, 조정 가능한 사고 깊이를 지원하며, 직접 실행하거나 Docker 내에서 실행할 수 있습니다.