[Open-WebUI] Google Gemini 연결 방법!!

 

 

 

1. Open-WebUI에서 Google Gemini 연결 방법 개요

Open-WebUI는 다양한 생성형 AI 모델을 웹 기반에서 쉽게 사용할 수 있도록 돕는 인터페이스입니다. 최근 Google에서 제공하는 Gemini AI 모델을 Open-WebUI에 연결할 수 있게 되면서, 더 많은 유저가 고성능 AI 기능을 손쉽게 활용할 수 있게 되었습니다.

이 가이드는 다음과 같은 3단계에 따라 Google Gemini를 Open-WebUI에 연동하는 과정을 설명합니다:

1. Google Gemini API 키 발급
2. Open-WebUI 관리자 설정에서 API 연결 구성
3. 모델 테스트 및 실사용 확인

---

2. Google Gemini란 무엇인가?

2.1 Google Gemini 개요

Gemini는 Google DeepMind가 개발한 최신 생성형 AI 모델입니다. OpenAI의 GPT 시리즈처럼 강력한 자연어 처리 능력을 보유하고 있으며, 텍스트 생성, 요약, 번역, 코드 작성, 문서 이해 등 다양한 작업에 활용됩니다.

2.2 Gemini의 특징

• 멀티모달 지원 (텍스트, 이미지 등)
• Google Cloud API 기반의 높은 안정성
• OpenAI API와 호환되는 REST API 제공

2.3 Open-WebUI에서 Gemini를 사용하는 이유

• 사용자 친화적인 인터페이스 제공
• 여러 모델을 동시에 관리 가능 (GPT-4, Claude, Mistral 등)
• 별도의 코드 없이 API만으로 연결 가능

---

3. Google Gemini API 키 발급 방법

3.1 Google AI Studio 접속

Google Gemini API를 사용하려면 먼저 API 키 발급이 필요합니다. 다음 절차를 따르세요:

1. Google AI Studio 접속: https://ai.google.dev
2. Google 계정으로 로그인
3. 새로운 프로젝트 생성
4. Gemini API 사용 설정
5. API Key 생성 및 복사

3.2 API 키 보안 유의사항

• API 키는 외부에 노출되지 않도록 철저히 보호해야 합니다.
• 테스트용과 운영용 API 키를 구분하여 관리하세요.
• API 사용량에 따라 요금이 발생할 수 있으므로 Google Cloud 콘솔에서 할당량을 꼭 확인하세요.

3.3 참고 링크

• 자세한 발급 방법: https://wikidocs.net/228927

---

4. Open-WebUI 관리자 패널에서 API 연결 설정하기

4.1 관리자 페이지 접속

Open-WebUI에 접속한 후 관리자 권한 계정으로 로그인하세요.

4.2 설정 메뉴 접근

1. 좌측 메뉴에서 설정 클릭
2. 연결(Connections) 탭 선택
3. OpenAI API 연결 항목에서 + 추가 클릭

4.3 새 연결 정보 입력

• 이름(Name): Gemini
• API 타입: OpenAI Compatible
• Base URL:
• bash
  복사편집
  https://generativelanguage.googleapis.com/v1beta/openai/
• API 키 입력: 이전 단계에서 복사한 키를 붙여넣기

4.4 모델 선택 및 저장

• 기본 모델로 gemini-pro, gemini-1.5-flash, gemini-1.5-pro 중 선택
• 선택 후 저장(Save) 버튼 클릭

---

5. Base URL과 설정값 정리

5.1 필수 입력값 요약

• Base URL:
• bash
  복사편집
  https://generativelanguage.googleapis.com/v1beta/openai/
• Authorization: Bearer {API_KEY}
• Content-Type: application/json

5.2 주요 설정 주의사항

• OpenAI API와 호환되기 때문에 기존 GPT 설정과 유사하게 구성 가능
• Base URL이 다르므로 반드시 정확히 입력 필요

---

6. Open-WebUI에서 Gemini 모델 테스트하기

6.1 새 채팅 시작

설정을 마쳤다면, Open-WebUI 메인 화면에서 “새 채팅(New Chat)”을 클릭하세요. 모델 선택 창에서 Gemini 2.0 Flash 또는 선택한 이름이 나타납니다.

6.2 작동 테스트

입력 예시:

“멘델의 유전법칙에 대해 알려줘.”

응답 예시:

“멘델은 완두콩 실험을 통해 유전 형질이 일정한 규칙에 따라 다음 세대로 전달된다는 사실을 밝혔습니다…”

정상적인 응답이 출력되면 설정이 성공한 것입니다. 일부 사용자는 “잘된다! YesSSSSSS!!!”라는 메시지를 통해 작동 확인을 표현했습니다.

---

7. Gemini 사용 예시

7.1 교육 분야

• 과학 개념 설명 (유전, 물리 법칙 등)
• 수학 문제 풀이
• 역사 요약

7.2 비즈니스 활용

• 회의록 요약
• 보고서 작성
• 이메일 자동 작성

7.3 콘텐츠 제작

• 블로그 글 초안 생성
• 유튜브 스크립트 작성
• 마케팅 문구 제안

---

8. 자주 묻는 질문 (FAQ)

8.1 연결이 되지 않을 때?

• API 키가 잘못되었거나 Base URL이 틀렸을 수 있습니다.
• Open-WebUI 서버 재시작 권장

8.2 모델이 안 뜰 때?

• 연결 시 이름을 지정한 모델이 기본 모델로 설정되어 있지 않을 수 있음
• 연결 정보를 삭제 후 재등록해보세요

8.3 속도가 느린 이유는?

• gemini-pro보다 gemini-1.5-flash가 응답 속도가 빠름
• 요청 토큰 수를 줄이면 속도 개선됨

---

9. 성공적으로 연동되었는지 확인하는 법

1. Open-WebUI에서 새 채팅 시작
2. 모델 선택창에서 Gemini 확인
3. 질문 입력 후 자연스러운 응답이 나오면 성공
4. 반응 속도와 답변 품질을 테스트해 다양한 활용에 대비

---

10. 결론 및 요약

10.1 핵심 요약

• Google Gemini API는 OpenAI 형식과 호환되어 Open-WebUI와 쉽게 연동 가능
• Base URL과 API Key만 정확히 입력하면 사용 준비 완료
• 다양한 분야에서 Gemini의 강력한 생성 능력을 활용 가능
• 사용 예시는 교육, 비즈니스, 콘텐츠 제작 등 다방면에 걸쳐 있음

10.2 참고 링크 정리

• Google AI Studio: https://ai.google.dev
• API 발급 가이드: https://wikidocs.net/228927
• Open-WebUI GitHub: https://github.com/open-webui/open-webui

 

 

===========================================

 

본인은 Google gemini를 선호하는 편인데 openai를 의식해서인지 과금이 생각보다 많이 저렴하다.

 

ollama에서도 gemini api를 이용할 수 있다. 

 

먼저 아래 글을 참고하여 gemini api를 발급받자. (본인은 카드 결재까지 등록함.)

 

https://wikidocs.net/228927

 

 

발급받은 api를 잘 저장하자.

 

관리자 패널 → 설정 → 연결에 들어가자

 

OpenAI API 연결 관리 → +를 누르면 아래와 같이 연결 추가 탭이 뜬다.

 

아래와 같이 Gemini 모델은 REST API와 함께 OpenAI 라이브러리를 사용하여 엑세스 할 수 있다.

https://ai.google.dev/gemini-api/docs/openai?hl=ko

 

따라서 Base_url은 아래와 같다.

https://generativelanguage.googleapis.com/v1beta/openai/

 

이제 여기에 발급받은 API를 복사 붙여넣기 하면 끝!

 

 

 

새 채팅에 들어가면 모델이 뜬 것을 알 수 있다.

 

 

gemini 2.0 flash thinking에 멘델의 유전법칙을 입력해 보았다.

 

 

 

잘된다! YesSSSSSS!!!

 

 

 

출처 : https://toyourlight.tistory.com/127