BotGem 설정

BotGem 은 크로스플랫폼 AI 데스크톱 클라이언트(macOS, Windows, iOS, Android 지원)로, 커스텀 API 제공자를 지원합니다.

사전 요구사항

OfoxAI 계정 및 API Key (여기서 발급 )
BotGem 설치 (다운로드 )

설정 단계

1단계: 설정 열기

BotGem을 실행하고 왼쪽 사이드바에서 설정을 클릭합니다.

설정 열기

2단계: Service Provider로 이동

Service Provider를 클릭합니다.

Service Provider

3단계: + 클릭 후 프로토콜 선택

+ 버튼을 클릭하고 프로토콜 유형을 선택합니다. OpenAI를 권장합니다:

프로토콜	선택	지원 모델
OpenAI Chat（권장）	OpenAI	`openai/gpt-6.1-sol`, `openai/gpt-6-luna`, `openai/gpt-5.5` 등 (일부 예시)
Claude	Claude	`anthropic/claude-sonnet-5.5`, `anthropic/claude-opus-5.5`, `anthropic/claude-haiku-5.5`
Gemini	Gemini	`google/gemini-3.8-flash`, `google/gemini-3.5-flash-lite`

BotGem은 OpenAI Responses 프로토콜(/v1/responses)을 지원하지 않습니다. 이 프로토콜은 messages 대신 input 필드를 사용하며, BotGem은 표준 Chat Completions 형식만 지원합니다.

OpenAI 선택

4단계: 설정 정보 입력

프로토콜별 API Server:

프로토콜	API Server
OpenAI Chat（권장）	`https://api.ofox.ai`
Claude	`https://api.ofox.ai/anthropic`
Gemini	`https://api.ofox.ai/gemini`

OpenAI Chat 예시:

항목	값
Name	`ofox` (원하는 이름)
API Server	`https://api.ofox.ai`
API Key	OfoxAI API Key
Models	Refresh로 자동 가져오기, 또는 직접 입력, 예: `gpt-4.1`

설정 정보 입력

https://api.ofox.ai 입력 시 BotGem이 자동으로 https://api.ofox.ai/v1/chat/completions로 보완합니다. OpenAI Chat으로 모든 모델을 사용할 수 있으며, 직접 입력 시 제공자/모델명 형식을 사용하세요 (예: anthropic/claude-opus-5.5, deepseek/deepseek-v4.1-flash).

5단계: 연결 확인 및 저장

연결 확인을 클릭합니다. “연결 성공!”이 표시되면 저장을 클릭합니다.

연결 성공

사용 시작

저장 후 메인 화면으로 돌아가 대화 시작을 클릭합니다. 채팅 창 상단에 현재 모델 이름이 표시됩니다. 메시지를 입력하여 대화를 시작하세요.

대화 시작

문제 해결

Q: 연결 확인이 실패합니다

API Server 주소가 올바른지 확인 (위 표 참조)
API Key가 OfoxAI 콘솔 에서 완전히 복사되었는지 확인
네트워크 연결 확인

Q: 원하는 모델이 목록에 없습니다

Models 오른쪽의 Refresh를 클릭하면 모델 목록을 자동으로 가져옵니다. 목록의 이름에는 접두사가 없습니다(예: gpt-4.1).

목록에 없는 모델을 사용하려면 제공자/모델명 형식으로 전체 모델 이름을 직접 입력해야 합니다. 전체 모델 목록은 OfoxAI 모델 마켓플레이스 에서 확인할 수 있습니다.