GewoonJaap/gemini-cli-openai

해결하는 문제

이 프로젝트는 Google의 Gemini 모델을 OpenAI 호환 엔드포인트로 변환하는 프록시 계층을 제공합니다. 사용자는 기존의 OpenAI API 패턴, SDK, 그리고 기존 AI 클라이언트(예: Open WebUI 또는 Cline)를 그대로 사용하면서도 Gemini의 고급 AI 기능에 접근할 수 있으며, 애플리케이션 로직을 변경할 필요가 없습니다.

작동 방식

이 프로젝트는 Cloudflare Worker로 배포되어 클라이언트와 Google의 API 사이를 연결하는 다리 역할을 합니다. 공식 Gemini CLI를 통해 OAuth2 인증을 사용하여 Google의 모델에 접근하며, 전통적인 API 키가 필요하지 않습니다. OpenAI 스타일의 요청과 응답을 번역하며, 스트리밍, 비전, 도구 호출을 모두 지원합니다.

대상 사용자

OpenAI API 형식만 지원하는 도구나 애플리케이션에서 Gemini 모델을 사용하고 싶은 개발자나 AI 애호가, 또는 Code Assist API를 통해 Google의 무료 트라이얼을 활용하고 싶은 사용자.

주요 특징

• OpenAI 호환성: 공식 SDK 및 라이브러리와 호환되는 OpenAI 엔드포인트의 즉시 대체 가능.
• OAuth2 인증: API 키 대신 Google 계정 인증을 사용.
• 실시간 스트리밍: 실시간 응답을 위한 서버 전송 이벤트(SSE) 지원.
• 고급 추론: 설정 가능한 추론 예산과 노력 수준으로 Gemini의 내장된 사고 기능 지원.
• 자동 모델 전환: 레이트 제한에 도달했을 경우 Pro 모델에서 Flash 모델로 자동 전환.
• 다중 모달 지원: base64 또는 URL을 통한 이미지 포함 비전 대화 지원.
• 도구 호출: OpenAI 호환 함수 호출 완전 지원.
• 에지 배포: Cloudflare Workers를 통해 글로벌 에지 배포로 낮은 지연 시간 구현.