ntthanh2603/gemini-web-to-api

해결하는 문제

일반적으로 Google Gemini의 모델을 프로그래밍 방식으로 사용하려면 공식 API 키와 할당량이 필요합니다. 이 프로젝트는 Gemini의 웹 인터페이스(브라우저에서 사용하는 챗봇)를 로컬 API 서버로 변환하여 이 장벽을 제거합니다. 브라우저 쿠키를 구성에 붙여넣기만 하면 서버가 인증 및 세션 유지를 처리하므로 API 키 없이 자신의 코드에서 Gemini를 호출할 수 있습니다.

작동 방식

서버는 로컬에서 실행되며(기본 포트 4981) 브라우저가 이미 만드는 batchexecute 요청을 사용하여 Gemini의 웹 백엔드와 통신합니다. 로그인한 브라우저 세션에서 쿠키 헤더를 추출하여 요청을 인증하는 데 사용합니다. 서버는 세션을 유지하고 차단을 피하기 위해 쿠키를 주기적으로 회전시킵니다. OpenAI 호환(/openai/v1), Claude 호환(/claude), Gemini 네이티브(/gemini)의 세 가지 API 스타일을 노출합니다. 모델 이름은 계정의 Gemini Web 모델 레지스트리에서 동적으로 검색되므로 코드 변경 없이 새 모델을 사용할 수 있습니다. 또한 동일한 인터페이스를 통해 이미지 생성, 이미지 입력, 비디오 생성, Canvas 문서 및 음악 생성을 지원합니다.

대상 사용자

API 키 없이 Gemini의 최신 모델 위에 애플리케이션을 구축하려는 개발자 또는 로컬에서 Gemini 통합을 테스트하려는 개발자에게 적합합니다. 쿠키 기반 인증으로 프로토타이핑하는 데도 유용합니다. 여러 API 형식을 제공하므로 기존 OpenAI, Claude 또는 Gemini SDK의 드롭인 대체품으로 작동합니다.

주요 기능

• API 키 불필요 — 브라우저 쿠키만 필요
• 단일 서버에서 OpenAI, Claude, Gemini API 프로토콜 지원
• Gemini Web 레지스트리에서 동적 모델 검색(예: gemini-auto, gemini-3.6-flash)
• 채팅을 넘어: 이미지 생성, 이미지 입력, 비디오 생성, Canvas 파일 및 음악 생성
• Go와 Fiber로 구축되어 고성능이며 Docker 및 Docker Compose 지원
• 차단을 피하기 위한 속도 제한, 쿠키 회전 및 세션 관리 포함
• Scalar UI를 통한 /docs의 대화형 API 문서