Huni 챗봇 기본형 사용법
Google Gemini API를 활용한 AI 챗봇의 설치부터 대화 관리까지, 단계별로 안내합니다.
Huni 챗봇 기본형이란?
Huni 챗봇 기본형은 Google의 Gemini API를 사용하는 웹 기반 AI 챗봇입니다. 로그인한 사용자만 이용할 수 있으며, 대화 내용은 자동으로 저장되어 이전 대화를 이어서 볼 수 있습니다. 구글 계정 또는 이메일·비밀번호로 가입 후, 본인의 Gemini API 키만 입력하면 바로 AI와 대화를 나눌 수 있습니다.
- Google Gemini API 기반의 자연어 대화
- 실시간 스트리밍 응답으로 빠른 답변 확인
- 대화별 저장 및 목록 관리
- 다크/라이트 테마 지원
사용 전 준비사항
Huni 챗봇 기본형을 사용하려면 회원가입(또는 로그인)과 Google Gemini API 키가 필요합니다.
- 계정: 구글 로그인 또는 이메일·비밀번호 회원가입 후 로그인합니다.
- API 키: Google AI Studio에서 Gemini API 키를 발급받아 상단 입력란에 넣습니다. (무료 할당량 내에서 사용 가능)
1. 로그인 및 회원가입
메인 화면에서 로그인하지 않은 경우 우측 상단에 로그인 버튼이 보입니다. 클릭하면 로그인 페이지로 이동합니다.
- 구글 로그인: Google 계정으로 한 번에 로그인할 수 있습니다.
- 이메일 회원가입: 사용법 페이지 또는 로그인 페이지에서 회원가입 링크를 통해 이메일, 비밀번호, 이름을 입력해 가입할 수 있습니다.
로그인 후에는 우측 상단에 로그인한 사용자 이름(또는 이메일)이 표시되며, 클릭 시 로그아웃 메뉴를 사용할 수 있습니다.
2. Gemini API 키 발급 및 입력
AI 응답을 받으려면 Google에서 제공하는 Gemini API 키가 필요합니다. 키는 브라우저에만 저장되며 서버에 전송되지 않습니다.
API 키 발급 방법
- Google AI Studio(https://aistudio.google.com)에 접속합니다.
- Google 계정으로 로그인한 뒤, 상단 메뉴에서 API 키 생성 또는 기존 키를 확인합니다.
- 생성된 API 키를 복사합니다.
- Huni 챗봇 기본형 상단의 "GEMINI API Key" 입력란에 붙여넣습니다.
API 키를 입력하지 않으면 채팅 요청 시 오류가 발생할 수 있으므로, 대화를 시작하기 전에 반드시 입력해 두세요.
3. 대화하기
새 대화 만들기
왼쪽 사이드바 상단의 새 대화 버튼을 누르면 새로운 대화가 생성되고, 해당 대화가 선택된 상태로 채팅 화면이 열립니다. URL에 대화 ID가 포함되므로 나중에 같은 링크로 다시 접속하면 해당 대화를 이어볼 수 있습니다.
메시지 보내기
화면 하단의 입력창에 질문이나 메시지를 입력한 뒤 전송 버튼을 누르거나 Enter를 치면, AI가 실시간 스트리밍으로 답변을 생성합니다. 응답이 끝날 때까지 기다리면 자동으로 대화 내용이 저장됩니다.
- 첫 번째 메시지가 대화 제목으로 자동 설정됩니다.
- 이전 대화를 선택하면 저장된 메시지 목록이 불러와집니다.
4. 대화 관리
왼쪽 사이드바에는 로그인한 사용자의 모든 대화 목록이 표시됩니다.
- 대화 선택: 목록에서 항목을 클릭하면 해당 대화의 메시지가 오른쪽 패널에 로드됩니다.
- 대화 삭제: 각 대화 항목의 휴지통 아이콘을 누르면 해당 대화가 삭제됩니다. 삭제된 대화는 복구할 수 없습니다.
대화 데이터는 로그인한 계정에만 연결되어 저장되므로, 다른 기기에서 같은 계정으로 로그인하면 동일한 대화 목록을 볼 수 있습니다.
자주 묻는 질문
- API 키는 어디에 저장되나요?
- API 키는 브라우저 메모리와 로컬 스토리지에만 저장되며, 서버에는 전송되지 않습니다. 채팅 요청 시 클라이언트에서 API 키와 함께 전달되어 Gemini API 호출에만 사용됩니다.
- 대화는 누가 볼 수 있나요?
- 대화는 로그인한 본인 계정에만 연결되어 저장됩니다. 다른 사용자나 관리자에게 노출되지 않습니다.
- Gemini API 사용 비용이 있나요?
- Google AI Studio에서 제공하는 무료 할당량 범위 내에서는 비용이 발생하지 않습니다. 사용량이 많을 경우 Google의 요금 정책을 확인하세요.