> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatHub

> ChatHub 브라우저 확장 연동 가이드

> 여러 모델 답변을 한 화면에서 비교하는 브라우저 확장 AI 클라이언트. GravitexAI로 100+ 모델 통합 접속

## 1. 제품 소개

ChatHub는 Chrome / Edge 브라우저 확장으로, 여러 AI 모델을 동시에 사용할 수 있습니다. 한 번 입력하면 최대 여섯 개 모델의 답변을 나란히 받아, 현재 질문에 가장 적합한 모델을 빠르게 판단할 수 있습니다. GravitexAI를 통해 ChatHub에서 OpenAI, Claude, Gemini, DeepSeek, Qwen 등 100+ 주류 모델을 통합 접속할 수 있습니다.

## 2. 핵심 기능: 동시 화면 비교

ChatHub와 다른 클라이언트의 가장 큰 차이는 **다중 모델 병렬 Q\&A**입니다:

* 같은 탭에서 2\~6개 모델에 동시에 질문
* 답변을 **나란히 / 표** 두 가지 뷰로 비교
* 임의 조합 지원: GPT-5.5 + Claude Opus 4.7 + Gemini 3 Pro + DeepSeek V4
* 비교 뷰에서 Markdown 렌더링, 코드 하이라이트, 이미지 미리보기 지원

<Tip>
  **적용 시나리오**

  * 코딩 / 버그 수정 시 GPT-5.5와 Claude Opus 4.7 수정안을 동시에 비교
  * 장문 작성 시 Claude Sonnet과 Qwen3.7의 표현 비교
  * 번역 / 요약 시 같은 문장을 GPT-5.5, Gemini 3 Flash, DeepSeek V4에 동시 전송
  * 모델 선정: 같은 문제로 여러 모델을 테스트해 주력 모델 결정
</Tip>

## 3. 설치

<Tabs>
  <Tab title="브라우저 확장">
    **방법 1: 스토어 온라인 설치(권장)**

    1. Chrome 웹 스토어에서 ChatHub‑All‑in‑One Chatbot 검색(개발자: chathub.gg)
    2. Chrome에 추가 → 확장 프로그램 추가
    3. 브라우저 우측 상단 퍼즐 아이콘(확장)에서 ChatHub를 찾아 툴바에 고정

    **방법 2: 수동 오프라인 설치(스토어 접속 불가)**

    1. GitHub에서 Release zip 다운로드
    2. 주소창에 `chrome://extensions/` 입력 후 개발자 모드 켜기
    3. 압축 해제된 확장 프로그램 로드 → 해제한 `dist` 폴더 선택
  </Tab>

  <Tab title="데스크톱">
    [https://chathub.gg/zh-CN/download](https://chathub.gg/zh-CN/download)에서 ChatHub를 다운로드해 설치합니다.
  </Tab>
</Tabs>

<Tip>
  * **사용자 지정 챗봇**은 브라우저 확장에서만 지원
  * 웹앱(app.chathub.gg), 데스크톱 클라이언트: 아직 사용자 지정 API 진입점 없음
  * 사용자 지정 챗봇은 **OpenAI 호환 API만 지원**
</Tip>

## 4. 빠른 연동(OpenAI 호환 형식)

가장 범용적인 방식이며 GravitexAI 전체 100+ 모델을 지원합니다.

### 1단계: GravitexAI API Key 발급

1. [GravitexAI 콘솔](https://maas.gravitex.ai/#/api-keys) 접속
2. 「API 키 새로 만들기」클릭 후 이름 지정·저장
3. `sk-`로 시작하는 키를 복사해 보관

### 2단계: ChatHub 설정 열기

1. 브라우저 확장에서 ChatHub 아이콘을 클릭해 앱 열기
2. 왼쪽 하단 **Settings**(톱니바퀴) 클릭해 전체 설정으로 이동
3. 【사용자 지정 봇】으로 스크롤 후 【추가】클릭

<img src="https://mintcdn.com/gravitexai/U0V-NTeQV7PqxAVn/images/chathub1.png?fit=max&auto=format&n=U0V-NTeQV7PqxAVn&q=85&s=ff38bf79f17da5b36834e1c257517bbe" alt="ChatHub 설정 열고 사용자 지정 봇 추가" width="1024" height="547" data-path="images/chathub1.png" />

### 3단계: GravitexAI 제공자 추가

<img src="https://mintcdn.com/gravitexai/U0V-NTeQV7PqxAVn/images/chathub2.png?fit=max&auto=format&n=U0V-NTeQV7PqxAVn&q=85&s=36ceb182b37b40c96debb3227285c532" alt="GravitexAI 사용자 지정 봇 구성" width="1024" height="486" data-path="images/chathub2.png" />

| 필드           | 입력값                                                                              | 설명                                                   |
| ------------ | -------------------------------------------------------------------------------- | ---------------------------------------------------- |
| **이름**       | `사용자 지정` 등                                                                       | 자유롭게 입력                                              |
| **API Host** | 드롭다운에서 OpenAI 선택 후 `https://api.gravitex.ai/v1` 입력                               | **반드시 `/v1` 포함**                                     |
| **API Key**  | 예: `sk-...`                                                                      | 1단계에서 받은 GravitexAI 토큰                               |
| **모델**       | `claude-sonnet-5`, `gpt-5.5`, `deepseek-v4-pro`, `kimi-k3`, `gemini-3.6-flash` 등 | [규격 모델 ID](https://maas.gravitex.ai/#/api-models) 사용 |

선택 고급 옵션:

1. **이미지 입력 지원**:
   * 체크 시 ChatHub 입력창에 이미지 업로드 버튼이 나타나 붙여넣기/업로드 가능
   * 미체크 시 업로드 UI가 숨겨지며, 모델이 비전을 지원해도 UI에서 이미지를 보낼 수 없음
2. **function calling 지원**: 도구 호출을 지원하는 모델일 때 체크
3. **고급 설정**: 기본 접힘, 필요 시 펼침

<Warning>
  **구성 포인트**

  * API Host 주소에 반드시 `/v1` 접미사 포함
  * 이미지 입력 체크는 클라이언트 업로드 UI만 엽니다. 백엔드 모델이 이미지를 미지원하면 전송 시 오류가 납니다
  * 브라우저 재시작 없이 즉시 적용
</Warning>

### 4단계: 모델 선택

설정 후 ChatHub 메인으로 돌아가면 드롭다운에서 추가한 모델 목록을 확인할 수 있습니다.

## 5. 세 가지 사용 모드

| 모드           | 트리거                          | 적용 시나리오              |
| ------------ | ---------------------------- | -------------------- |
| **단일 모델 대화** | ChatGPT처럼 한 모델과 대화           | 일상 Q\&A, 단일 모델 강점 작업 |
| **다중 모델 비교** | 입력창 오른쪽에서 2\~6개 모델 체크 후 전송   | 모델 선정, 최적 답 탐색       |
| **웹 어시스턴트**  | 웹 페이지 텍스트 선택 시 ChatHub 툴바 표시 | 논문 번역/요약, 메일 윤문      |

<Tip>
  **비교 모드 팁**

  * 비교 모드에서 각 모델 답변은 **독립**이며, 왼쪽 메인 대화창은 기본 모델을 표시
  * 모든 답변 내보내기: 대화 우측 상단 **Export**(Markdown / JSON / PNG)
  * **스타일 차이가 큰** 조합(예: GPT-5.5 + Claude Opus 4.7 + DeepSeek V4)을 권장
</Tip>

## 6. 고급: 다중 벤더 비교

ChatHub의 강점은 「여러 벤더를 동시에 실행」하는 것입니다. GravitexAI 한 번 연동으로 비교 모드에서 임의 벤더 모델을 섞을 수 있습니다.

### 비교 조합 추천

| 작업 유형             | 추천 모델 조합                                         | 이유              |
| ----------------- | ------------------------------------------------ | --------------- |
| **코드 생성 / 버그 수정** | GPT-5.5 + Claude Opus 4.7 + DeepSeek V4          | 주류 코딩 능력 + 가성비  |
| **장문 / 창작**       | Claude Sonnet 4.5 + Qwen3.7-Max + GPT-5.5        | 중국어 표현 + 서양식 서사 |
| **번역 / 다국어**      | GPT-5.5 + Gemini 3 Flash + DeepSeek V4           | 세 벤더 교차 검증      |
| **추론 / 수학**       | GPT-5.5 (xhigh) + Claude Opus 4.7 + Gemini 3 Pro | 최상위 추론 트리오      |

## 7. 지원 모델

GravitexAI를 통해 ChatHub는 OpenAI, Google Gemini, Claude, DeepSeek, 중국어 모델 등 100+ 주류 AI 모델을 지원합니다.

<Card title="인기 모델 추천 보기" icon="star" href="https://maas.gravitex.ai/#/api-models">
  최신 모델 추천, 성능 비교, 시나리오별 가이드. 텍스트·코딩·빠른 응답·이미지·비디오 전 영역.
</Card>

<Info>
  **여기에 구체 모델을 나열하지 않는 이유**

  AI 모델 업데이트가 매우 빠릅니다. 가장 정확한 정보는 [모델 추천 페이지](https://maas.gravitex.ai/#/api-models)에서 최신 목록·성능·사용 팁을 확인하세요.
</Info>

## 8. 문제 해결

<AccordionGroup>
  <Accordion title="연결 실패">
    1. API 키가 `sk-`로 시작하고 불필요한 공백이 없는지 확인
    2. API Base URL 확인: `https://api.gravitex.ai/v1`
    3. [GravitexAI 콘솔](https://maas.gravitex.ai/#/api-keys)에서 토큰 활성화·잔액 확인
    4. 잔액 부족도 401을 반환할 수 있으니 계정 잔액 확인
  </Accordion>

  <Accordion title="모델이 표시되지 않음">
    * 모델 목록 자동 새로고침 대기
    * 「모델 새로고침」버튼 수동 클릭
    * API 키 권한 확인
  </Accordion>

  <Accordion title="비교 모드에 한 모델만 표시">
    * 입력창 오른쪽에서 여러 모델을 체크했는지 확인
    * 모든 모델이 같은 provider이거나, 서로 다른 provider라도 각각 구성되어 있는지 확인
  </Accordion>

  <Accordion title="응답이 느림">
    * 더 빠른 모델로 전환
    * 네트워크 지연 확인
    * 컨텍스트 길이 줄이기
  </Accordion>
</AccordionGroup>

## 9. 모범 사례

### 성능 최적화

1. **모델 선택**
   * 작업 복잡도에 맞는 모델 선택
   * [모델 추천](https://maas.gravitex.ai/#/api-models)에서 최신 가이드 확인

2. **비교 전략**
   * 동질 모델(예: GPT 두 개) 비교는 의미가 적음
   * **강점이 다른** 모델 선택: 코딩·글쓰기·추론·번역 각각 하나
   * 한 번에 4개 이상 비교하지 않기 — 토큰 비용이 급증

3. **리소스 관리**
   * API 사용량 모니터링
   * 사용 한도 알림 설정
   * 확장 버전 정기 업데이트

### 보안

* API 키 공유 금지
* 키 정기 교체
* 브라우저에 강한 비밀번호 사용
* 민감 정보 신중히 처리

### 팀 협업

ChatHub는 개인 사용이 중심이지만 다음으로 팀을 지원할 수 있습니다:

* 프롬프트 템플릿 공유
* 대화 기록 내보내기·공유
* API 구성 표준 통일

## 10. 비교 우위

### 다른 클라이언트 대비

| 기능              | ChatHub     | 단일 모델 클라이언트 | 기타 확장  |
| --------------- | ----------- | ----------- | ------ |
| **동시 화면 다중 모델** | ✅ 핵심        | ❌           | 소수 지원  |
| **브라우저 사이드바**   | ✅           | ❌           | 일부     |
| **웹 어시스턴트**     | ✅           | ❌           | 일부     |
| **사용자 지정 API**  | ✅           | ✅           | ✅      |
| **크로스 플랫폼 동기화** | ✅(브라우저 동기화) | ❌           | 구현에 따라 |
| **로컬 대화 기록**    | ✅           | 구현에 따라      | 구현에 따라 |

### ChatHub를 선택하는 이유

1. **모델 선정 도구**: 여러 모델을 동시에 돌리는 대체 불가 가치
2. **다중 모델 혼합 호출**: OpenAI / Claude / Gemini / 중국어 모델 임의 조합
3. **웹 몰입**: 브라우저 확장으로 어떤 페이지에서도 호출
4. **프라이버시 우선**: 대화 로컬 저장, 확장이 데이터를 수집하지 않음
5. **지속 업데이트**: 활발한 유지보수

<Info>
  **추가 도움**: [bd@gravitex.ai](mailto:bd@gravitex.ai) 또는 13603055233으로 문의하세요.
</Info>
