AIstudioProxyAPI: Gemini 2.5 Pro 모델 API 무제한 사용

일반 소개

AI스튜디오프록시API는 Node.js와 Playwright 기술을 사용하여 OpenAI API를 에뮬레이션하는 오픈 소스 프로젝트입니다. Google AI 스튜디오 웹 기반 쌍둥이자리 모델 대화 기능을 표준 API 인터페이스에 추가했습니다. 개발자는 이 프록시 서비스를 사용하여 OpenAI API를 지원하는 클라이언트(예: Open WebUI, NextChat)에 Google AI 스튜디오 무제한으로 제공되는 기능. 이 프로젝트는 복잡한 구성이 필요하지 않으며 Google AI Studio 기능을 빠르게 통합하려는 개발자에게 적합합니다. 현재 프로젝트는 개인적으로 유지 관리되고 업데이트가 자주 이루어지지 않으며 헤드리스 모드를 지원하지 않으므로 Chrome 디버깅 포트를 사용할 수 있는지 수동으로 확인해야 합니다.

기능 목록

• offer /v1/chat/completions 노래로 응답 /v1/models 엔드포인트와 호환되는 OpenAI API 클라이언트를 지원합니다.
• 스트리밍 응답 지원(stream=true)를 사용하여 타자기 효과를 얻을 수 있습니다.
• 비스트리밍 응답 지원(stream=false)를 호출하면 전체 JSON을 한 번에 반환합니다.
• 사용자 입력 프롬프트를 자동으로 최적화하고 Google AI Studio의 출력 형식을 조정합니다.
• Chrome 인스턴스를 자동으로 시작하고 연결하며 디버그 포트와 창 크기를 설정합니다.
• 포트 충돌을 처리하거나 기존 Chrome 인스턴스에 연결하기 위한 대화형 옵션을 제공합니다.

도움말 사용

설치 프로세스

AIstudioProxyAPI는 배포가 간단하지만 환경이 올바르게 구성되어 있는지 확인해야 합니다. 자세한 단계는 다음과 같습니다:

1. 클론 창고
   터미널에서 다음 명령을 실행하여 프로젝트 코드를 가져옵니다:

   git clone https://github.com/CJackHwang/AIstudioProxyAPI
   cd AIstudioProxyAPI

2. 종속성 설치
   프로젝트 종속성 express, cors, playwright 노래로 응답 @playwright/test. 패키지 관리자에 따라 다음 명령 중 하나를 선택합니다:

   npm install
   # 或
   yarn install
   # 或
   pnpm install
   

   설치가 완료되면 종속성이 자동으로 구성됩니다.@playwright/test 어설션 기능을 제공합니다.

3. 서비스 시작
   다음 명령을 실행하여 상담원 서비스를 시작합니다:

   node auto_connect_aistudio.cjs
   

   스크립트가 작동합니다:

   • 종속성이 완료되었는지 확인합니다.
   • Chrome 디버그 포트 확인(기본값) 8848) 무료 여부에 관계없이 사용할 수 있습니다.
   • Chrome 창 크기 설정하기(기본 너비) 460px).
   • Chrome을 자동으로 실행하고 Google AI 스튜디오 페이지를 엽니다.

   포트가 사용 중인 경우 스크립트에서 기존 Chrome 인스턴스에 연결하거나 포트를 지우고 다시 시도할지 묻는 메시지가 표시됩니다. 인증을 완료하려면 Google AI 스튜디오 페이지에 수동으로 로그인해야 합니다.

주요 기능 사용

AIstudioProxyAPI의 핵심은 클라이언트가 OpenAI API 호환 인터페이스를 통해 Google AI Studio의 Gemini 모델 기능을 사용할 수 있도록 하는 것입니다. 작동 방식은 다음과 같습니다:

1. 클라이언트 구성
   OpenAI API를 지원하는 클라이언트(예: Open WebUI)에서는 API 주소를 프록시 서비스 주소로 설정합니다(기본값). http://localhost:2048). 클라이언트 코드를 변경할 필요 없이 인터페이스가 완벽하게 호환됩니다.
2. 대화 요청 보내기
   클라이언트를 사용하여 OpenAI API와 동일한 형식으로 대화 요청을 보냅니다. 예시:

   {
   "model": "gemini",
   "messages": [
   {"role": "system", "content": "你是一个助手"},
   {"role": "user", "content": "请解释量子力学"}
   ],
   "stream": true
   }
   

   • 설정 stream=true 실시간 대화에 적합한 스트리밍 응답을 받아보세요.
   • 설정 stream=false 일회성 처리에 적합한 전체 JSON 응답을 가져옵니다.
3. 프롬프트 단어 최적화
   프록시 서비스는 사용자 입력을 자동으로 래핑하여 특정 태그(예 <<<START_RESPONSE>>>)를 사용하여 Google AI 스튜디오의 출력이 예상 형식인지 확인하세요. 개발자는 큐 단어를 수동으로 조정할 필요가 없습니다.
4. Chrome 인스턴스 관리
   실행 후 Chrome 창이 열려 있어야 하며 Google AI 스튜디오 페이지가 충돌하지 않아야 합니다. 페이지가 응답하지 않으면 관련 프로세스를 모두 닫으세요(node 노래로 응답 chrome)를 다시 실행하고 node auto_connect_aistudio.cjs.

주요 기능 작동

• 스트리밍 응답클라이언트 측 설정 stream=true응답은 대화형 애플리케이션에 적합한 타자기 효과와 함께 그대로 표시됩니다.
• 포트 충돌 처리스크립트가 다음을 감지합니다. 8848 포트가 사용 중이면 기존 Chrome 인스턴스에 연결할지 아니면 포트를 지울지 선택하라는 메시지가 표시됩니다.
• 창 크기 조정: 만약 460px 모니터에 맞지 않는 너비, 수정 가능 auto_connect_aistudio.cjs 정곡을 찌르세요 --window-size 매개변수.

문제 해결

• 페이지 로드 실패네트워크 연결을 확인하고 수동으로 접속을 시도합니다. https://aistudio.google.com/prompts/new_chat 를 클릭하고 로그인합니다.
• 포트 점유: 실행 lsof -i :2048 점유 프로그램 확인, 폐쇄 또는 변경 server.cjs 정곡을 찌르세요 SERVER_PORT.
• 플레이라이터가 준비되지 않았습니다.Chrome 창이 닫혀 있지 않은지 확인하고 시작 스크립트를 다시 실행합니다.

애플리케이션 시나리오

1. AI 대화 기능의 신속한 통합
   개발자는 앱에 AI 대화 기능을 추가하고 싶지만 OpenAI API 할당량으로 인해 제한을 받고 있습니다. aIstudioProxyAPI를 사용하면 개발자가 Google AI Studio의 무료 할당량을 활용하여 익숙한 OpenAI API 인터페이스를 통해 기능을 빠르게 구현할 수 있습니다.
2. 로컬 개발 및 테스트
   개발팀은 로컬 환경에서 AI 대화 기능을 테스트할 때 AIstudioProxyAPI를 통해 OpenAI API를 에뮬레이션할 수 있으므로 추가 API 쿼터를 구매할 필요가 없고 비용도 절감할 수 있습니다.
3. 교육 및 연구
   학생이나 연구원이 대규모 모델 대화 기능을 실험해야 하지만 API 액세스 권한이 부족한 경우, AIstudioProxyAPI는 학술 연구를 위해 Gemini 모델에 쉽게 액세스할 수 있도록 지원합니다.

QA

1. AIstudioProxyAPI는 어떤 클라이언트를 지원하나요?
   OpenAI API를 지원하는 모든 클라이언트(예: Open WebUI, NextChat)는 클라이언트 코드를 수정하지 않고도 사용할 수 있습니다.
2. 헤드리스 모드가 지원되지 않는 이유는 무엇인가요?
   Google AI 스튜디오의 자동 감지 기능은 헤드리스 모드를 인터페이스된 Chrome 인스턴스로 제한합니다.
3. 점령된 항구를 어떻게 처리하나요?
   프로브 2048 어쩌면 8848 포트 점유, 충돌하는 프로그램 닫기 또는 수정 server.cjs 포트 구성은
4. 서비스에 지속적인 네트워킹이 필요한가요?
   예, 프록시 서비스를 사용하려면 페이지가 제대로 로드되도록 Google AI 스튜디오 페이지에 인터넷에 액세스해야 합니다.