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

# Cherry Studio에서 APIMart 사용하기

> Cherry Studio 데스크톱 클라이언트에서 APIMart API 서비스를 구성하고 사용하는 방법에 대한 자세한 가이드입니다. 이 가이드는 Cherry Studio에서 APIMart API를 구성하여 풍부한 AI 모델 리소스에 액세스하는 방법을 안내합니다.

## 사전 준비

시작하기 전에 다음을 확인하세요:

1. **Cherry Studio 설치 완료**\
   [Cherry Studio 공식 웹사이트](https://cherry-ai.com/)에서 운영 체제에 적합한 버전을 다운로드하고 설치하세요

2. **APIMart API 키 획득**\
   [APIMart 콘솔](https://apimart.ai/keys)에 로그인하여 API 키(`sk-`로 시작)를 받으세요

<Note>
  **팁:** APIMart 계정이 없는 경우 먼저 [APIMart](https://apimart.ai)에서 등록하고 API 키를 받으세요.
</Note>

## 1단계: Cherry Studio 설정 열기

Cherry Studio를 실행한 후 설정 페이지로 이동합니다:

1. 오른쪽 상단의 **⚙️ 설정** 아이콘(톱니바퀴 아이콘)을 클릭
2. 또는 키보드 단축키 사용:
   * Windows/Linux: `Ctrl + ,`
   * macOS: `Cmd + ,`

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/main-interface.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=ef3f913c9b4888b65c903676b6cd9292" alt="Cherry Studio 메인 인터페이스" width="960" height="600" data-path="images/integrations/cherry-studio/main-interface.png" />
</Frame>

<caption>*Cherry Studio 메인 인터페이스, 오른쪽 상단 톱니바퀴 아이콘을 클릭하여 설정 열기*</caption>

## 2단계: APIMart 모델 플랫폼 추가

### 2.1 모델 서비스 관리 액세스

설정 페이지에서:

1. 왼쪽 메뉴에서 **모델 서비스** 옵션 찾기
2. 클릭하여 모델 서비스 관리 페이지로 이동

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/settings-providers.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=39ebb46b27592e425b4e3596bda8aaa4" alt="Cherry Studio 설정 - 모델 서비스" width="960" height="600" data-path="images/integrations/cherry-studio/settings-providers.png" />
</Frame>

<caption>*설정 페이지 왼쪽 메뉴에서 "모델 서비스" 옵션 찾기*</caption>

### 2.2 APIMart 공급자 추가

1. 모델 서비스 페이지 하단에서 **"+ 추가"** 버튼 클릭

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/add-provider-config.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=a1c312ef03c4ca62778f56e0faf92647" alt="공급자 추가 대화 상자" width="960" height="600" data-path="images/integrations/cherry-studio/add-provider-config.png" />
</Frame>

<caption>*"+ 추가"를 클릭하면 공급자 추가 대화 상자가 열립니다*</caption>

2. **"공급자 추가"** 대화 상자에서 입력:
   * **공급자 이름**: `APIMart` (사용자 정의 가능)
   * **공급자 유형**: `OpenAI` 선택

3. **"확인"** 버튼 클릭

### 2.3 APIMart API 정보 구성

공급자를 추가한 후 오른쪽 구성 영역에서 API 정보 입력:

| 필드         | 값                                 |
| ---------- | --------------------------------- |
| **API 키**  | APIMart API 키 (`sk-xxxxxxxxxxxx`) |
| **API 주소** | `https://api.apimart.ai`          |

<Note>
  **중요:**

  * API 주소는 `https://api.apimart.ai`이어야 합니다 (`/v1` 또는 다른 경로 포함 안 함)
  * API 키는 APIMart 콘솔에서 받은 `sk-`로 시작하는 키여야 합니다
  * 입력 후 **"검사"** 버튼을 클릭하여 연결을 테스트할 수 있습니다
</Note>

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/settings.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=04ff4519dfde1316b66006e9e15e576d" alt="APIMart API 정보 구성" width="960" height="600" data-path="images/integrations/cherry-studio/settings.png" />
</Frame>

<caption>*API 키와 API 주소를 입력하고 APIMart 공급자 상태가 ON(녹색 스위치)인지 확인*</caption>

## 3단계: 모델 추가 및 관리

### 3.1 모델 관리 열기

APIMart 공급자 구성 완료 후:

1. APIMart 공급자 오른쪽 상단의 스위치가 **ON**(녹색)인지 확인
2. 오른쪽 구성 영역에서 **"모델"** 섹션 찾기
3. **"관리"** 버튼을 클릭하여 모델 선택 창 열기

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/provider-list.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=5c21258d0aa5aeca5372a4cf3e0ab2a4" alt="APIMart 모델 관리" width="960" height="600" data-path="images/integrations/cherry-studio/provider-list.png" />
</Frame>

<caption>*"관리" 버튼을 클릭하여 APIMart 모델 선택 창 열기*</caption>

### 3.2 원하는 모델 추가

모델 선택 창에서:

1. 검색 상자를 사용하여 특정 모델 검색 가능
2. 상단의 카테고리 탭으로 필터링: **전체**, **추리**, **시각**, **연결**, **무료**, **임베딩**, **재순위**, **도구**
3. 원하는 모델을 찾아 오른쪽의 **+** 버튼을 클릭하여 추가:
   * `gpt-4o` / `chatgpt-4o` - OpenAI GPT-4o 모델
   * `gpt-4o-mini` - 더 빠르고 경제적인 버전
   * `claude-3` 시리즈 - Claude 3 모델 (여러 변형 포함)
   * `claude_code_sonnet-4` - Claude Code Sonnet 4
   * `claude_code_haiku-4` - Claude Code Haiku 4
   * `gemini-2.0-flash-exp` - Google Gemini 2.0 Flash

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/model-selection.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=1b451945dbe65866baa8b3cfc3e703fc" alt="추가된 모델 목록" width="960" height="600" data-path="images/integrations/cherry-studio/model-selection.png" />
</Frame>

<caption>*추가된 모델은 오른쪽에 표시되며 확장하여 구체적인 변형을 볼 수 있습니다*</caption>

4. 필요한 모든 모델을 추가한 후 모델 선택 창 닫기

<Tip>
  **추천 모델:**

  * 💰 **가성비:** `gpt-4o-mini`, `claude_code_haiku-4`
  * 🚀 **고성능:** `gpt-4o` / `chatgpt-4o`, `claude_code_sonnet-4`
  * 🎨 **멀티모달:** `claude-3` 시리즈, `gemini-2.0-flash-exp`
</Tip>

## 4단계: 대화 시작

구성 완료 후 사용을 시작할 수 있습니다:

1. 메인 인터페이스로 돌아가서 상단의 \*\*"+"\*\*를 클릭하거나 기존 대화 선택
2. 대화 페이지 상단에서 모델 선택기 클릭
3. **APIMart** 공급자 아래의 모델 선택
4. AI와 대화 시작!

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/new-chat.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=0e5589ab2d63f0711f0290bb8a56e002" alt="새 대화" width="960" height="600" data-path="images/integrations/cherry-studio/new-chat.png" />
</Frame>

<caption>*새 대화를 만들고 APIMart 공급자와 모델 선택*</caption>

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/chat-interface.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=7aef37a2bce5ee3f99415e5bf47a3543" alt="대화 인터페이스" width="960" height="600" data-path="images/integrations/cherry-studio/chat-interface.png" />
</Frame>

<caption>*Cherry Studio 대화 인터페이스 예시*</caption>

## 자주 묻는 질문

### Q1: APIMart 서비스에 연결할 수 없나요?

**해결 방법:**

1. **Base URL 확인**:
   * Base URL이 `https://api.apimart.ai`인지 확인
   * `/v1` 접미사를 추가하지 마세요

2. **API Key 확인**:
   * API Key가 올바르고 `sk-`로 시작하는지 확인
   * [APIMart 콘솔](https://apimart.ai/keys)에서 키가 유효한지 확인

3. **네트워크 연결 확인**:
   * `https://api.apimart.ai`에 액세스할 수 있는지 확인
   * 중국에 있는 경우 프록시 구성이 필요할 수 있습니다

### Q2: 모델 목록이 비어 있거나 새로 고칠 수 없나요?

**해결 방법:**

1. **수동으로 모델 추가**:
   * 자동 새로 고침이 실패하면 일반 모델을 수동으로 추가할 수 있습니다
   * 모델 관리에서 모델 이름을 수동으로 입력(예: `gpt-4o`)

2. **API 권한 확인**:
   * API Key에 모델 목록에 대한 액세스 권한이 있는지 확인
   * APIMart 지원팀에 문의하여 계정 상태 확인

### Q3: 대화 중 오류 메시지가 표시되나요?

**일반적인 오류 및 해결 방법:**

| 오류 메시지                      | 원인                   | 해결 방법                  |
| --------------------------- | -------------------- | ---------------------- |
| `401 Unauthorized`          | 유효하지 않거나 만료된 API Key | API Key를 다시 받아 구성 업데이트 |
| `429 Too Many Requests`     | 요청 속도 제한 초과          | 잠시 기다렸다가 재시도           |
| `500 Internal Server Error` | 임시 서버 문제             | 몇 분 기다렸다가 재시도          |
| `insufficient_quota`        | 계정 잔액 부족             | 콘솔에서 충전                |

### Q4: API 사용량 및 비용을 어떻게 확인하나요?

[APIMart 콘솔](https://apimart.ai/overview)에 로그인하여 확인:

* 📊 API 호출 통계
* 💰 비용 세부 정보
* 📈 사용 추세 차트

## 기능

Cherry Studio + APIMart를 사용하면 다음을 수행할 수 있습니다:

* 💬 **다중 모델 대화** - 동일한 인터페이스에서 다양한 AI 모델 사용
* 🖼️ **이미지 이해** - 이미지 입력을 지원하는 다중 모달 대화
* 📝 **컨텍스트 관리** - 대화 기록 및 컨텍스트의 지능형 관리
* 🎨 **사용자 정의 프롬프트** - 프롬프트 템플릿 생성 및 관리
* 📊 **대화 내보내기** - 대화 기록을 Markdown 등의 형식으로 내보내기
* 🔄 **모델 비교** - 여러 모델을 동시에 사용하고 출력 비교

## 지원 및 도움말

문제가 발생한 경우:

* 📚 [APIMart 문서](https://docs.apimart.ai)
* 💬 [Discord 커뮤니티](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 기술 지원: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="APIMart 시작하기" icon="rocket" href="https://apimart.ai">
  지금 APIMart에 등록하고 API 키를 받아 AI 여정을 시작하세요!
</Card>