Gemini 연동

Google Gemini API를 Starnion에 연결하면 Gemini 모델을 대화에 사용할 수 있습니다. 이미지 분석, 멀티모달 처리 등 Gemini의 강력한 기능을 활용해 보세요.

개요

Gemini 연동을 사용하면:

대화 모델: Gemini 2.0 Flash, Gemini 1.5 Pro, Gemini 1.5 Flash 사용 가능
임베딩: gemini-embedding-001 (768차원) 지원
이미지 분석: 이미지를 업로드하여 내용 분석 및 설명
멀티모달 처리: 텍스트와 이미지를 함께 이해하는 복합 처리

기본 프로바이더: Gemini는 Starnion의 기본 프로바이더입니다. 별도의 API 키 설정 없이도 무료 티어로 시작할 수 있습니다.

지원 모델

모델	특징	권장 용도
Gemini 2.0 Flash	빠른 응답, 최신 모델	일상 대화, 빠른 질답
Gemini 1.5 Pro	긴 컨텍스트 (최대 1M 토큰)	긴 문서 분석, 복잡한 추론
Gemini 1.5 Flash	균형 잡힌 성능	범용 대화
gemini-embedding-001	768차원 임베딩	문서 벡터화, 유사도 검색

사전 준비: Google AI Studio API 키 발급

1단계: API 키 생성

Google AI Studio에 접속합니다.
Google 계정으로 로그인합니다.
Get API key 버튼을 클릭합니다.
Create API key 클릭 → 프로젝트 선택 또는 새 프로젝트 생성.
생성된 키를 복사합니다 (AIza... 형식).

무료 한도: 분당 15회 요청, 일 1,500회 요청 (2025년 기준).

설정 방법

웹 UI에서 API 키 등록

Starnion 웹 UI에 로그인합니다.
좌측 메뉴 → Settings → Models 탭 클릭.
Google Gemini 프로바이더를 선택합니다.
API Key 필드에 복사한 키(AIza...)를 붙여넣습니다.
사용할 모델을 체크합니다 (복수 선택 가능).
저장 버튼 클릭.

API 키는 저장 즉시 자동 검증됩니다.

사용 방법

대화에서 모델 선택

대화 시작 시 모델 선택 드롭다운에서 Gemini 모델을 선택하거나, 페르소나에 Gemini 모델을 연결하여 자동 적용할 수 있습니다.

이미지 분석

나: (이미지 첨부) 이 사진에 뭐가 있어?
봇: 이 이미지에는 한강 야경이 담겨 있어요.
    다리 위의 조명이 물에 반사되어 아름다운 풍경을 만들고 있네요.

나: (그래프 이미지 첨부) 이 차트 분석해줘
봇: 이 막대그래프는 월별 매출 추이를 보여주고 있어요.
    3월부터 매출이 꾸준히 증가하고 있으며, 6월에 최고점을 기록했어요.

긴 문서 분석

나: (PDF 첨부) 이 보고서 요약해줘
봇: (Gemini 1.5 Pro 사용)
    이 보고서의 주요 내용:
    1. 2026년 1분기 매출 전년 대비 15% 증가
    2. 신규 서비스 출시로 MAU 30% 성장
    ...

임베딩 설정

Gemini의 임베딩 모델은 문서 검색, 유사도 분석 등에 사용됩니다.

모델: gemini-embedding-001
차원: 768
용도: 대화 기록 벡터화, 문서 검색, 패턴 분석

임베딩 설정은 starnion.yaml 또는 환경 변수에서 구성할 수 있습니다.

다른 프로바이더와 비교

항목	Gemini	OpenAI	Anthropic
무료 티어	O (일 1,500회)	X	X
최대 컨텍스트	1M 토큰	128K 토큰	200K 토큰
이미지 분석	O	O	O
임베딩	O	O	X
한국어 성능	우수	우수	우수

문제 해결

“Gemini API 키가 유효하지 않아요”

API 키가 AIza... 형식인지 확인합니다.
Google AI Studio에서 키가 활성 상태인지 확인합니다.

“요청 한도를 초과했어요” (429 오류)

무료 한도(분당 15회, 일 1,500회)를 초과했습니다.
잠시 기다리거나 다른 프로바이더로 전환하세요.

이미지 분석이 동작하지 않아요

Gemini 2.0 Flash 또는 Gemini 1.5 Pro 모델을 사용하고 있는지 확인합니다.
이미지 형식이 지원되는지 확인합니다 (JPEG, PNG, GIF, WebP).

FAQ

Q: Gemini를 무료로 계속 사용할 수 있나요? A: 네, Google AI Studio의 무료 한도 내에서는 계속 무료로 사용할 수 있습니다. 한도 초과 시에는 유료 요금이 발생할 수 있습니다.

Q: Gemini와 다른 프로바이더를 동시에 설정할 수 있나요? A: 네, 여러 프로바이더의 API 키를 동시에 등록하고 대화별로 모델을 선택할 수 있습니다.

Q: Gemini 임베딩을 사용하려면 별도 설정이 필요한가요? A: Gemini API 키가 등록되면 임베딩도 자동으로 사용 가능합니다. starnion.yaml에서 세부 설정을 조정할 수 있습니다.