LLM Wiki

gemini-web2api: 웹 채팅 화면을 OpenAI 호환 API로 바꾸는 단일 파일 프록시

Properties2
descriptiongemini-web2api는 Google Gemini 웹 채팅 화면이 내부적으로 사용하는 요청 흐름을 OpenAI 호환 REST API 형태로 감싸는 단일 파이썬 파일 프록시입니다.
tagsai-agents, research

5 min read

출처

개요

gemini-web2api는 Google Gemini 웹 채팅 화면이 내부적으로 사용하는 요청 흐름을 OpenAI 호환 REST API 형태로 감싸는 단일 파이썬 파일 프록시입니다. /v1/chat/completions, /v1/models 같은 OpenAI 형식 엔드포인트를 제공해 OpenAI SDK나 호환 클라이언트에서 Gemini 웹을 호출할 수 있게 합니다. 공식 Gemini API가 아니라 Gemini 웹 프런트엔드의 비공개 프로토콜을 재현하는 방식이므로, Google의 웹 구조 변경이나 서비스 정책에 영향을 받을 수 있습니다. 기본적으로 httpx만 있으면 로컬에서 실행할 수 있고, Docker 실행과 프록시 설정도 지원합니다. 이미지 업로드 미지원, Pro 모델 사용 시 유료 계정 쿠키 필요, 대량 요청 제한 가능성 등 명시된 한계가 있습니다.

핵심 포인트

  • gemini-web2api는 Gemini 웹 채팅 화면을 OpenAI 호환 API처럼 사용할 수 있게 해주는 로컬 프록시입니다.
  • OpenAI 호환 엔드포인트인 /v1/chat/completions, /v1/models를 제공해 OpenAI SDK, Cherry Studio, ChatBox 같은 클라이언트와 연결할 수 있습니다.
  • 동작 방식은 Gemini 웹 앱이 사용하는 StreamGenerate 엔드포인트와 프런트엔드의 모델 매핑 정보를 활용하는 것으로, 공식 문서화된 API가 아닙니다.
  • 선택적 API 키, 함수 호출, 웹 검색, 사고 깊이 조절, Codex CLI 및 Gemini CLI 호환 기능을 지원한다고 README가 설명합니다.
  • 유료 Gemini Advanced 계정 쿠키가 없으면 gemini-3.1-pro 요청도 실제로는 Flash 모델로 라우팅됩니다.
  • 이미지 업로드는 지원하지 않으며, 각 요청은 독립 대화로 처리되어 멀티턴 맥락은 이전 메시지를 프롬프트에 포함하는 방식으로 흉내 냅니다.
  • Google이 웹 프런트엔드나 내부 프로토콜을 바꾸면 작동이 중단될 수 있고, 세션 쿠키 사용은 약관상 위험을 사용자가 판단해야 합니다.

왜 중요한지

이 프로젝트는 OpenAI 호환 인터페이스를 기준으로 만들어진 도구와 클라이언트를 Gemini 웹 환경에 연결하려는 실험적 접근을 보여줍니다. 공식 API 가입, 키 발급, 과금 설정 없이 로컬에서 빠르게 테스트할 수 있다는 점은 개발자에게 편리할 수 있습니다. 다만 공식 API가 아닌 웹 내부 프로토콜 재현에 의존하므로 안정성, 지속 가능성, 계정 및 약관 리스크를 함께 고려해야 합니다. 따라서 프로덕션 용도보다는 구조를 이해하거나 로컬 실험용으로 검토하는 것이 원문 내용에 더 가깝습니다.

후속 링크 및 키워드

원문 보존 위치

원문 전체는 raw source: web-2026-07-05-pytorchkr-topic-11075-gemini-web2api-openai-compatible-proxy에 source_url 및 HTML 원문과 함께 저장되어 있습니다.

백링크