> ## 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.

# Cherry Studio

> Cherry Studio 클라이언트 연동 가이드

## 소개

Cherry Studio는 여러 대규모 언어 모델을 지원하는 강력한 AI 채팅 클라이언트입니다. **GravitexAI**를 통해 Cherry Studio에서 다양한 주류 AI 모델을 쉽게 사용할 수 있습니다.

## 빠른 연동

### 1. API 키 발급

[GravitexAI](https://maas.gravitex.ai)에서 API 키를 발급받으세요.

### 2. 설정

1. Cherry Studio를 엽니다
2. 왼쪽 설정 아이콘을 클릭합니다
3. "Model Service"를 선택합니다
4. 다음 항목을 입력합니다:
   * API URL: `https://api.gravitex.ai`
   * API Key: GravitexAI 콘솔에서 발급한 키
5. "➕ Add"를 클릭하여 저장합니다

<Warning>
  API URL은 반드시 `https://api.gravitex.ai`여야 합니다
</Warning>

### 3. 모델 추가

1. 대상 모델을 검색합니다 (예: `gemini-3.1-pro-preview`)
2. 모델 이름 옆 아이콘을 클릭하여 설정합니다
3. 필요에 따라 모델 변형을 활성화/비활성화합니다
4. 오른쪽 버튼으로 상세 설정을 진행합니다

## 지원 모델

### 최신 추천

| 시리즈               | 모델 ID                    | 특징                                      |
| ----------------- | ------------------------ | --------------------------------------- |
| Gemini 3.1 Pro    | `gemini-3.1-pro-preview` | 복잡한 멀티모달 작업을 위한 Google의 업그레이드된 핵심 지능 모델 |
| GPT-5.4           | `gpt-5.4`                | 강력한 종합 성능을 갖춘 OpenAI의 최신 메인라인 모델        |
| Claude Sonnet 4.6 | `claude-sonnet-4-6`      | 장문 및 코딩 작업을 위한 Anthropic의 최신 Sonnet 모델  |
| DeepSeek V3.2     | `deepseek-v3-2-251201`   | 일반 워크로드를 위한 고가성비 하이브리드 추론 모델            |

### 클래식 안정형

| 시리즈                   | 모델 ID                           | 사용 사례                  |
| --------------------- | ------------------------------- | ---------------------- |
| Claude Opus 4.6       | `claude-opus-4-6`               | 복잡한 추론, 코드 리뷰, 고난이도 작업 |
| Gemini 3.1 Flash Lite | `gemini-3.1-flash-lite-preview` | 빠른 응답, 저비용 고동시성 채팅     |

### 선택 가이드

* **멀티모달**: `gemini-3.1-pro-preview`
* **일상 채팅**: `gpt-5.4` 또는 `gemini-3.1-flash-lite-preview`
* **장문**: `claude-sonnet-4-6` 또는 `claude-opus-4-6`
* **복잡한 추론**: `gpt-5.4-pro`, `claude-opus-4-6`, `deepseek-r1-250528`

## 고급 기능

### 이미지 지원

비전 기능이 있는 모델(예: `GPT-4V`)의 경우:

1. 설정에서 "Images"를 활성화합니다
2. 비전 지원 모델을 선택합니다
3. 채팅에서 이미지를 직접 업로드합니다

### 스트리밍 출력

Cherry Studio는 기본적으로 스트리밍 출력을 지원하여 더 부드러운 대화를 제공합니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="연결 실패">
    * API 키가 올바른지 확인하세요
    * API URL이 `https://api.gravitex.ai`인지 확인하세요
    * 네트워크 연결을 확인하세요
  </Accordion>

  <Accordion title="모델 사용 불가">
    * 계정 잔액이 충분한지 확인하세요
    * 모델이 구독 플랜에 포함되어 있는지 확인하세요
    * 다른 모델로 전환해 보세요
  </Accordion>
</AccordionGroup>

## 팁

1. **현명한 선택**: 작업 요구사항에 맞는 모델을 선택하세요
2. **최신 정보 유지**: 새 모델 출시 소식을 확인하세요
3. **사용량 모니터링**: GravitexAI 콘솔에서 사용량을 확인하세요