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

# Cherry Studio 사용자 지정 모델 구성 가이드

> Platform API guide - Ace Data Cloud

## 1. API Key 가져오기

[Ace Data Cloud 애플리케이션 목록](https://platform.acedata.cloud/console/applications)을 열고, 사용 가능한 애플리케이션에 들어가 API Key를 복사합니다.

![Ace Data Cloud API Key 가져오기](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. Provider 추가

Cherry Studio를 열고 **설정 → 모델 서비스 → 제공업체 추가**로 이동하여 다음을 입력합니다:

| 필드 | 값 |
| - | - |
| 제공업체 이름 | `Ace Data Cloud` |
| 제공업체 유형 | `OpenAI` |
| API Key | 방금 복사한 API Key |
| API 주소 | `https://api.acedata.cloud` |

![Cherry Studio Ace Data Cloud Provider 추가 구성 화면](https://cdn.acedata.cloud/b67a927eae62.png)

Cherry Studio는 OpenAI 유형에 대해 `/v1/chat/completions`를 자동으로 완성합니다. 범용 엔드포인트를 사용할 때 주소 끝에 `#`를 추가하지 말고, 모델 계열별로 여러 Provider를 만들 필요도 없습니다.

## 3. 모델 추가 및 활성화

1. **모델 목록 가져오기**를 클릭합니다; 현재 버전이 자동 가져오기를 지원하지 않는 경우 [모델 카탈로그](https://platform.acedata.cloud/models)로 이동하여 확인한 후, `claude-opus-5`, `gpt-6-sol`과 같은 대상 모델 이름을 수동으로 추가합니다.
2. API Key 옆의 확인 버튼을 클릭하여 연결을 검증합니다.
3. Provider의 **활성화** 스위치를 켭니다.
4. 대화 모델 선택기에서 방금 추가한 모델을 선택합니다.

![Cherry Studio Provider 및 모델 목록](https://cdn.acedata.cloud/149de1d088bf.png)

> 모델 가져오기 또는 수동 추가를 완료한 후, 오른쪽 상단의 Provider 스위치를 켜십시오.

`OK만 답장`을 보내고, [사용 내역](https://platform.acedata.cloud/console/usages)에서 호출을 확인합니다. 401이면 Key를 확인하십시오; 모델이 표시되지 않으면 Provider가 활성화되어 있는지 확인하십시오; 404이면 수동으로 입력한 모델 이름이 카탈로그의 `id`와 완전히 일치하는지 확인하십시오.

## GPT Image 2 정보

Cherry Studio의 일반 사용자 지정 채팅 Provider는 Images API를 직접 호출할 수 없습니다. `gpt-image-2` 생성 및 편집은 Ace Data Cloud 전용 인터페이스를 사용해야 합니다:

* [GPT Image 2 이미지 생성](https://platform.acedata.cloud/documents/openai-images-generations)
* [GPT Image 2 이미지 편집](https://platform.acedata.cloud/documents/openai-images-edits)

`/openai/images/generations`를 채팅 Provider에 입력하지 마십시오.

## 공식 참고 자료

* [Cherry Studio](https://cherry-ai.com/)
* [사용자 지정 서비스 제공업체](https://docs.cherry-ai.com/pre-basic/providers/zi-ding-yi-fu-wu-shang)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.